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PREFACE 


This manual describes the OS/32 Edit Utility, its commands, error 


messages, and the basic editor concepts and is especially written 
for the new user. 


Chapter 1 introduces Edit and outlines the system requirements. 
Chapter 2 describes building, loading, and starting the editor 
from the system console and a multi-terminal monitor (MTM) 
terminal. Chapter 3 describes all the Edit commands and gives 
examples of their use. Chapter 4 guides a user through a sample 
editing session. 


Appendix A summarizes Edit commands. Appendix B iS a message 
summary . Appendix C contains ASCII-EBCDIC conversion tables. 
Appendix D contains bidirectional input/output control (BIOC) 
function control codes applicable to users of the OS/32 Edit 
program. 


Revision FOl RO2 of this manual contains new parameters 
(CONTINUE/EXIT and WINDOW/NOWINDOW) for the OPTION command. 


This manual is intended for use with the OS/32 RO0O7.2 software 
release and higher. 


For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
OPERATING SYSTEM/32 (OS/32) EDIT 


1.1 INTRODUCTION 

OS/32 Edit is a disc-based editor that operates on an 0S/32 
system and on an OS/32 system with MTM. Edit can be executed in 
an interactive or batch environment and editing is performed on 
a line-by-line basis. Data can be appended to a file, altered, 
and saved via the commands described in Chapter 3. 

1.2 EDIT REQUIREMENTS 

These system resources are required for Edit: 

e The minimum hardware required for O0S/32 

e Disc devices 

e Temporary file support 

The pure segment of the editor requires 32.50kb of memory. Each 
impure segment requires a minimum of 9.25kb of memory. This 
minimum amount includes 4kb for a buffer in which the _ editor 
maintains tables. 

1.3 SYSTEM ENVIRONMENTS 

Edit can be executed in an interactive or batch environment which 
is determined by the user-specified command input device in the 
START command. See Section 2.4. © 

1.3.1 Interactive Environment 

In an interactive environment, a dialogue is carried on between 
the user and the system. Edit waits for your command, processes 
it, then prompts you for the next command. . Commands are entered 
interactively through such devices as a CRT or teletype. There 
are two modes of operation in an interactive environment: 


e Command mode 


@e Input mode 


48-008 FOO RO2 LL 


During command mode, editing is performed on a copy of your file 
residing in memory. You can change, alter, delete, and locate 
data that has been previously contained in the file. 


During input mode, you can change existing data and enter new 
data in a file. Entering a null line (a carriage return being 
the only new information on an input line) transfers you’ from 
input mode to command mode. 


1.3.1.1 Prompts 


In command mode, a greater than sign (>) is displayed to the list 
device. It is a command prompt informing the user to enter a 
command : 


> 


When a command is typed in, followed by a carriage return, Edit 
interprets the command and performs the operation. Some commands 
are repeated every time the carriage return is depressed until a 
new command is entered. 


Input mode causes a line prompt to be displayed. The prompt 
character is preceded by a line number: 


1 > 
2 > 


In input mode, Edit will continue to display line prompts until 
a null line is entered. Edit will then return to command mode. 


1.3.1.2 Control Characters 
Some interactive devices allow you to modify data before it is 


transmitted to the buffer via control characters. Table 1-l 
lists the control characters and their functions. 


TABLE 1-1 EDIT CONTROL CHARACTERS 


| CHARACTER | FUNCTION H DEVICE 
CTRL X Voids line being typed CRT, TTY, 


{ 
' 
i MODEL 1100, 1200 
i VDU, Carousel 


a nc Ne SR NY amd RY NN ee OE ES EY Ce Se SD ee ee ces ee SE rm  ReeD Se SOY Se be one ee ORE mee AR ES Se SE De ND ee Ye en OD mee come wee Ge 


{ ‘ 

1 

H a | Deletes character directly ;{; CRT, TTY, { 

H } preceding symbol ; Carousel H 

 iodleieateals tm ak wee samme use Ve ee st em) MS een OS SOON Man wa ane ae a ca mw MR cee ne A SOS ae com oe A vm See ee ins SS es co, 
CTRL H Moves cursor back 1 space, CRT, MODEL 1100, 


( ' 

t ' 

i Geleting character in that ; 1200 VDU, 
i} Space ;} Carousel 


a ee Oe me ee ce A MO Mee NM aes ee mem ca Oy mee ee a RS A me me ee er NOS pe i aD RS me Ge fees eee 
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1.3.2 Batch Environment 
In a batch environment, a sequence of Edit commands is input from 
a disc file, card reader, or magnetic tape device and is 
processed as a background task. The list device is specified in 
the START command. User commands, Edit responses and messages 
are output to the list device. 
If an error occurs during batch processing, execution of the 
current job is halted and this message is displayed: 

-END OF TASK CODE = 2 
Normal completion is indicated by the following message: 


-END OF TASK CODE = 0 


1.4 FILES 

Data is retained by saving it to a file residing on a disk 
device. Files are identified by a unique name and specified by 
file descriptors according to the standard OS/32 format. 

1.4.1 File Descriptors 

File descriptors, abbreviated as fd, are entered in a_ standard 


format. 


Format: 


voln: 
: [filename] [- Cext]] [/ file class] 


dev: 
Parameters: 


voln: is a l- to 4-character alphanumeric string 
specifying the name of a disc volume. The 
first character must be alphabetic and the 


remaining, alphanumeric. If the volume name 
is omitted, the default is the system or user 
volume. 

dev: is a l- to 4-character alphanumeric string 
specifying a device name. The first character 
must be alphabetic and the remaining, 


alphanumeric. 
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filename is a l- to 8-character alphanumeric string 
specifying the name of a file. The first 
character must be alphabetic and the 
remaining, alphanumeric. If a filename is 
specified when a device name is specified, the 
filename is ignored. 


-ext is a l- to 3-character alphanumeric. string 
specifying the extension to a filename. 


file class is a l-character alphabetic string specifying 
the type of file class. The file class types 
are: 


P for private file 
G for group file 
S for system file 
If the file class is omitted, the default is 
P in an MTM environment, and S in an operating 
system environment. 
1.5 EDIT FEATURES 
This section describes editing modes and the methods used _ to 
identify lines of data during an editing session. 
1.5.1 ASCII and Hexadecimal Editing 
Edit provides two modes of editing: 
e ASCII mode 
e Hexadecimal (hex) mode 
In ASCII mode, Edit interprets character strings as they are 
represented. In hexadecimal mode, Edit interprets character 
strings as pairs of hexadecimal digits. All editor commands’ can 
be used in hexadecimal as well as ASCII mode. Choice of modes is 
specified in the OPTION command. ASCII-EBCDIC conversion tables 
are in Appendix C. 
1.5.2 Identifying Data 
Lines of data can be identified by specifying line numbers or 


Character strings; by assuming the current line; by using 
delimiters; or by specifying ranges of line numbers. 


1-4 48-008 FOO RO2 


1.5.2.1 Line Numbers 


Line numbers provide a convenient way to identify lines of data 
during an editing session. Edit assigns line numbers beginning 
with 1, incremented by one, up to line number 99999. The APPEND 
command assigns Line numbers in increments of one, and is used to 
enter new data. The INSERT, REPLACE, and INCLUDE commands insert 
new information into existing data at a specified position. Line 
numbers for inserted lines have a decimal part following the 
integer number. 


The decimal part is generated by incrementing the existing line 
number by .0Ol. The line number of each inserted line is .01 
greater than the previous line number. Incrementing stops if a 
new line number is the same as an existing line number. Thus, 
several lines can exist with the same line number. In this 
situation, if a line number parameter is used to specify a line, 
the first Line with the duplicate number following the current 
line is assumed. Other lines can be located by using the plus 
(+) or minus (-) commands to position the desired lines. Enter 
a SAVE command to renumber the entire file. 


1.5.2.2 Character Strings 

A line of data can be identified by specifying a sequence of 
unique characters within the line. When a string is specified in 
a command format, the string identifies a line to the editor. 
When the specified string is not unique to one line being edited, 


the first Line containing the string is assumed to be the desired 
line. 


Format: 
/string/ [col] 
Parameters: 
/ is a non-alphanumeric character delimiting a 


string. See section 1.5.2.4. 


string is a unique, alphanumeric sequence of 
characters. 


col is a decimal number from 1 to 256 specifying 
the starting column location of a character 
string. 
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1.5.2.3 Current Line 

During editing, the editor maintains a line pointer positioned at 
the current’ line. Edit commands with no_ range parameter 
specified operate on the current line. When changing from input 
mode to command mode, the current line is the last line entered 
from the command device; when changing from command mode to input 


mode, the current line is the line following the last line 
edited. 


1.5.2.4 Delimiters 

A delimiter is a non-alphanumeric character that separates 
character strings in an input line. Delimiters allow the editor 
to recognize the beginning and end of a string. Any 
non-alphanumeric character is valid except: 

e semicolon 

@® comma 

® minus sign 

e blank 


@e a character that appears in the string itself 


The slash (/) is used to represent a delimiter in this manual. 


1.5.2.5 Ranges 


A range refers to specific line numbers in a file, or unique 
character strings that identify specific line numbers ina file. 
A minus sign is used to separate range arguments. 


Format: 
+e no; non 
/string, / [col] /strings/ [col] 
Parameters: 
line no, is the line or beginning line of a range to be 
operated on. 
Line non is the ending line of the range to be operated 


on. 
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/ is a non-alphanumeric character delimiting a 
string. 


string, is a unique, alphanumeric character string or 
beginning string of a range to be operated on. 


string, is a unique, alphanumeric character string or 
. ending string of a range to be operated on. 


col is a decimal number from 1 to 256 indicating 
the column locations of string, and string,. 


Functional Details: 


Any combination of range arguments is permitted. Edit searches 
the file for the specified lines or strings. After a match is 
made, the actual function of the command is performed. 


Data is operated on beginning with the first line or string 
specified, and continuing through the last line or string 
specified. If the second argument is omitted, all lines from the 
line or string specified to the end-of-file are operated on. If 
the first argument is omitted, all lines from the current line to 
the line or string specified are operated on. 


If the entire range parameter is omitted, the default is the 
current line. 


Examples: 


1-16 indicates lines 1 through 16 
inclusive. 

range parameter specifies current line only. An 

omitted | exception to this is the SAVE 


command where, if the range is null, 
all lines of data are still saved. 


ng indicates line 1 only. 


-10 specifies current line through line 
10 inclusive. 


= specifies current Line through 
end-of-file inclusive. 


L= indicates line 1 through 
end-of-file. 
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/CHARS /-5 | is the line where the character 
string CHARS appears to line 5. 


/ CHARS /-/DELN/ . are the lines identified by the 
first occurrence of CHARS to the 
first occurrence of DELN. 


Leads 8 Carriage Return 


The carriage return (CR) transmits a line of data to be processed 
and switches an Edit user from input mode to command mode. 


1.5.3 Formatting Data 


Edit presets options that control the data format of a file. 
These defaults allow the user to create a file without having to 
specify line length, line numbers, etc. See Section 3.22. 


1.5.3.1 Line Length 


The maximum number of characters allowed in each line is called 
line length. When appending to create a new file; i.e., no GET 
command is issued prior to the APPEND and notruncate isin 
effect, the record length defaults to 80 bytes. If a GET is 
issued to an existing disc file and OPTION LENGTH (see OPTION 
command) was not specified, the length defaults to the record 
length of the file. The maximum characters per line is 256. You 
can specify line length via the length parameter in the OPTION 
command. 


If the number of bytes per record is less than the editor line 
length, each line is padded with blanks. You can specify a 
column number, via the TRUNCATE command, indicating the column at 
which truncation will occur. Characters displayed beyond the 
specified column are lost when a line of data is expanded. The 
default is column 73. The TRUNCATE command remains in effect 
until a NOTRUNCATE command is entered. 


1.5.3.2 Text Display 


Several commands cause data to be displayed with the appropriate 
line number. The decimal portion of the integer is only output 
if it is not equal to zero. Trailing blanks are not output. 
Data is continued on the next line, up to 80 characters, when 
necessary. 


When the tab option is in effect, data is displayed according to 
column settings defined by the tab option. See Section 1.5.3.3. 
When the mode specified in the OPTION command is hexadecimal, all 
data is displayed in hexadecimal format. 
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1.5.3.3 Tab Settings 


Tab control causes data to be aligned at preset positions and 
frees the user from manually spacing data. 


The tab parameter of the OPTION command allows the user to set 
tabs and designate a tab control character. The tab settings are 
used only when text is entered at the command device. The editor 
expands the line entered according to the tab control character 
and settings, and retains the line in its expanded form. See 
Section 3.22. 


1.5.3.4 Column Display 


Edit displays a ruler at the user's console via the RULER 


command. Use this as a guide to determine where columns begin 
and end. . 
Example: 
>RULER 
0 1 2 3 5 6 


4 
1234567890123456789012345678901234567890123456789012345678901234567 


When hexadecimal is entered as the mode in the OPTION command, 
column numbers are output in hex. For example: 


> RULER 


0102030405060708090A0BOCODOEOFO101112131415161718191A1B1C1DIELF 202122 


1.6 VERIFICATION 


Lines that are located, changed, or altered are automatically 
displayed to the list device. Editing verification can be turned 
off via the noverify option in the OPTION command. 


1.7 COMMANDS 


Commands are entered following the command prompt and are 
transmitted for processing by entering a CR. 


1.7.1 Edit Command Syntax 


Multiple commands can be entered on one line if they are 
separated by semicolons (;). An exception to this is the AGAIN 
command which must appear by itself on a command line. When 
multiple commands are entered on the same line, they are executed 
sequentially. If an error occurs, any subsequent commands on the 
line are ignored. 
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In a batch environment parameters can be continued by entering a 
comma as the last character and continuing the parameters on the 


following line. 


1.7.2 Statement Syntax Conventions 


These statement syntax conventions are used in all command and 


instruction formats: 
Capital letters, 


parentheses, and 
punctuation marks 


Lowercase letters 


n 


Under lining 


RAUSE 


Ellipsis 


Lettering with shading 


Braces 


. 


Brackets 


| 


must be entered exactly as shown 


represent parameters or information 
provided by the user 


indicates only the underlined por- 
tion of the entry is required 


represents an indefinite -number of 
parameters or a range of parameters 


represents a default option 


represent required parameters from 
which one must be chosen 


represent an optional parameter that 
can be chosen 
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Commas 


Braces inside brackets 


A] 


Comma preceding braces 
inside brackets 


at 


Comma inside brackets 


® 


Comma outside brackets 
except last parameter 


N00 


Equal sign separating 
keyword from parameters 


KEYWORD=param 


1.8 MESSAGES 


separate parameters and substitute 
missing positional parameters 


represent optional parameters from 
which one can be chosen 


must be entered if one of the 
optional parameters is chosen 
However, if the parameters are not 


positional and the first parameter 
of the statement is not chosen, the 
parameter specified as the first is 
not preceded by a comma. 


must be entered if the optional 
parameter is chosen 


must be entered in place of missing 
positional parameters and to 
separate optional parameters’ that 
are chosen. Commas are omitted for 
trailing parameters and a comma must 
be entered with the last specified 
parameter. 


must be entered to 
parameter with keyword 


‘associate 


Four types of messages are output to the command device during an 


Edit session: 


e Messages pertaining to incorrect syntax 


@ Messages pertaining to incomplete execution of a command 


e Messages pertaining to incomplete command execution because of 


a more serious error 


e Information messages 
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Messages indicating incorrect syntax are preceded by a question 
mark (?) and are generated when the editor cannot recognize a 
command or its parameters. The editor does not attempt to 
execute the specified command. 


Execution messages are preceded by an exclamation point (!) and 
are output during execution. Determine where in the file 
execution stopped, correct the error, and re-execute the command. 


Messages preceded by two exclamation points (!!) denote a 
serious problem. In some cases, the only way to recover is to 
attempt to save the current data to a file different from the 
source file, end the session, and restart. 


Information messages are output to help you in an editing 
session. Some examples of these messages are reminders to save 
text and indications that a function has completed normally. 


For a complete list of messages and meanings see Appendix B. 
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CHAPTER 2 
BUILDING, LOADING, AND STARTING THE EDITOR 


2.1 BUILDING EDIT AS A SYSTEM IMAGE LOAD MODULE 


This sequence of commands builds the shared HELP segment and Edit 
task as a system image load module: 


TITLE 'EDIT32 - SHARED SEGMENT' 

ESTABLISH IMAGE, ADDR=CO000 

RESOLVE HELPRO62.SEG,SIZE=(X400,X1000) , ADDR=E0000 
INCLUDE EDIT32,EDIT32A 

MAP EDITRO62.MAP 

BUILD EDITRO62.SEG 

END 


TITLE 'EDIT32 TASK' 

ESTABLISH TASK 

RES EDITRO62.SEG,ADDR=C0000,ACC=RE 
RES HELPRO62.SEG,ADDR=E0000 ,ACC=RE 
INCL EDIT32,DR 

INCL EDIT32,EDIMP 

MAP EDIT32. MAP , ALPHA, XREF , ADDR 
BUILD EDIT32.TSK 

END 


For an explanation of these commands, see the OS/32 Link 
Reference Manual. rs 


2.2 LOADING EDIT FROM AN MIM TERMINAL 
After building the image load module, EDIT32.TSK, the module can 
be loaded into memory with this command: 
Format: 
LOAD fd[,segsize increment] 


Parameters: 


fd is the file descriptor of the Edit load module 
to be loaded into memory. 
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segsize is a decimal number in kb specifying the 
increment additional memory to be added to the task's 
impure segment. 


Functional Details: 


When the Edit load module is loaded into memory, the system 
displays an asterisk (*) prompt, indicating the editor can be 
started. 

In order to successfully load the task, the shared HELP segment 
must be on the volume under the account number from which the 
task is to be loaded, or on the default system volume under 
account number 0. 
Under MTM, the editor should run with task executing prompts 
Gisabled (command PREVENT PROMPTS). 

2.3 LOADING EDIT FROM THE SYSTEM CONSOLE 


The LOAD command loads Edit from the system console. 
Format: 

LOAD taskid [: [fd] [ segsize ieceemeney| 
pat ansters: 


taskid specifies the name of the module after it is 
loaded into the foreground segment of memory 
as the currently-selected task. 


fd is the file descriptor of the editor image 
load module to be loaded into memory. If this 
parameter is omitted, the default is 
taskid.TSK. 

segsize is a decimal number’ in kb specifying the 

increment additional memory to be added to the task's 


impure segment. 


Functional Details: 


The system sets Edit as the currently-selected task. When the 
system displays the asterisk prompt, the editor can be started. 
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2.4 STARTING EDIT 


The START command starts Edit. 
Format: 

START [,COMMAND=fd,] [,LIST=fd,] 
Parameters: 


COMMAND= fd, specifies the input device from _ which 
commands are to be entered. If this parameter 
is omitted, the default is the console device 
(CON:). If the specified command input device 
is interactive and the LIST parameter is 
omitted, all output data and messages are sent 
to the command device. If the command input 
device is batch, the LIST parameter must _ be 
specified. 

LIST= fd2 specifies the output device to which 
output data is sent. If this parameter is 
omitted and the command device is interactive, 
the output data and all messages are sent to 


the command device. If the command device is 
batch, the LIST parameter must be specified. 


Functional Details: - 


If both parameters in the START command are omitted, the default 
is the console device (CON:). 


Error Messages: 


! INVALID COMMAND DEVICE 


The file or device specified as the command device of the 
START command is syntactically incorrect. 


! INVALID LIST DEVICE 


The file or device specified as the list device is 
syntactically invalid. 
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{DUPLICATE START OPTION 


A command or list parameter was entered more than once. 


!SYNTAX ERROR IN START OPTIONS 


The command or list parameter was entered incorrectly. 


ILIST OPTION OMITTED - BATCH MODE 


A non-interactive device was specified as the command device, 
and the list parameter was not specified. 


!UNABLE TO ASSIGN LIST DEVICE 


The file or device specified as the list device cannot be 
assigned. 


-END OF TASK CODE=1 


The editor cannot proceed without valid START parameters. 
Code 1 indicates abnormal job termination. 
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CHAPTER 3 
08/32 EDIT COMMANDS 


3.1 INTRODUCTION 


This chapter describes the following OS/32 Edit commands: 


AFTER 
AGAIN 
ALTER 
APPEND 
BEFORE 
BOTTOM 
CHANGE 
COLUMN 
DELETE 


INCLUDE 
INSERT 

LINE NUMBER 
MOVE 

NOF IND 
NOTRUNCATE 
OPTION 

PAUSE 

REPLACE 

RULER 

SAVE 

SCREEN 

SEND STOP 
SUBSTITUTE 
TOP 

TRUNCATE 

TYPE 

(+) PLUS SIGN 
(-) MINUS SIGN 
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3.2 AFTER COMMAND 


The AFTER command inserts a mew character string immediately 
after a user-specified character string in a line of data. 


For 


Par 


mat: 


Line no, 
AFTER /string/newstr ing | / 
/ [col] 


i 


ameters: 


col 
newstring 
Line no, 
line non 


string, 


/string, 


Line nop 
/strings/ — 


is a non-alphanumeric character delimiting a 
string. The blank, minus sign, comma, 
semicolon, and any character that appears in 
the string itself cannot be used. 


is a sequence of unique alphanumeric 
characters. The new string is inserted after 
this string. 


is a decimal number from 1 to 256 indicating 
the starting column location of string, and 
string. 


is a sequence of unique alphanumeric 
characters to be inserted after the specified 
character string. 


is the line number or first line number of a 
range of lines where the newstring will be 
inserted after the specified string. 


is the ending line number of a range where the 
newstring will be inserted after the specified 
string. 


is a unique character string or first unique 
character string of a range which determines 
where in the file the newstring will be 
inserted after the specified string. 
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is the ending unique character string of a 
determines where in the file the 


which 


string, 
range 
newstring will be inserted after the specified 


string. 


Functional Details: 


inserted string produces a line longer than the 
or if the portion of data to the left of 


If the 
following message is 


established line length, 
is expanded, the 


the truncate column 
displayed when any non-blank characters are lost: 


!NON-BLANK CHARACTERS LOST 


Examples: 


»AFTER/DISC/F ILE/2 


After the character string DISC, 
FILE in line 2. 


»AFTER/DISC/F ILE/2-/TAPE/ 


After the character string DISC, 
FILE from line 2 to the first occurrence 
character string TAPE. 


»AFTER/DISC/F ILE/2- 


After the character string DISC, 
string FILE from line 2 to end-of-file. 
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insert character string 


insert character string 
of the 


insert the character 


3.3 AGAIN COMMAND 


The AGAIN command re-executes a previously specified command 
line. 


Format: 
AGAIN 
Functional Details: 


Commands that are not re-executed are DELETE, GET, END, and a 
Line of data entered with a line number. When the AGAIN command 
is entered following these commands, the following message _ is 
displayed: 


?REPEAT DISALLOWED 
The AGAIN command must be the only command on the input line. 
Examples: 


OYE: i 
l This is an example 
2 of how 
3 the AGAIN 
4 command works. 
>AG 
1 This is an example 
2 of how 
3 the AGAIN 
4 command works. 
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3.4 ALTER COMMAND 


The ALTER command modifies entire lines of text. 


Format: 


ALTER [line no,] [-[1ine non] ] 


The 


/string/ 


~— PMP DY 


- NOTE 


characters used to alter a line can 


be used more than once on the same line. 


Parameters: 


line no, 


Line non 


i) 
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is the line number or first line number of a 
range to be altered. If no line number is 
specified, the current line is altered. 


is the ending line number of a range of data 
to be altered. 


represents a space. All spaces retain the 
current character in that position. 


The cursor is moved by depressing the space 
bar. 


is the backslash character that replaces’ the 
current character within a space. 


is the at sign character that deletes the 
current character and compresses the 
surrounding letters in the rest of the line. 


is the percent. sign character that ‘inserts a 
single space preceding the percent sign. 


%/string/ is the percent sign followed by a slash, a 
character string, and a slash, that inserts 
the character string preceding the percent 
sign. 


x indicates any character other than a blank, \, 
@, and %. The character replaces the current 
character in that position. 


Functional Details: 


All local CRTs are sysgened by default with the bidirectional 
input/output control (BIOC) driver. The capability to use BIOC 
editing features depends on certain BIOC-related features’ that 
are made available to the user at sysgen time. See the OS/32 
System Generation/32 (SYSGEN/32) Reference Manual. 


Operation of the ALTER command is dependent upon the _ above 
conditions plus the use of the BIOC option. If the BIOC option 
is enabled, the ALTER command displays the specified line and 


places the cursor at the end of the line. At this point, the 


line may be edited using the BIOC line-editing features. See 
Appendix D. 


After the Line has been changed to the desired appearance, a 
carriage return (CR) is entered to terminate the ALTER command. 
Edit proceeds to display the next line of the range, if any. If 
this was the last or only line specified, Edit returns to the 
command mode. 


If the terminal is sysgened with other than the BIOC driver, the 
BIOC option should be disabled (OPTION NOBIOC). Then the ALTER 
command works as described in the following paragraphs. 


After the ALTER command is entered, Edit responds by printing the 
specified line as it currently exists. The line number is’ then 
printed again. Changes to the original line now can be entered 
in the corresponding character positions. 


The alter line can be terminated at any character position. All 
remaining characters in the line are retained. If OPTION VERIFY 
is selected, Edit responds by printing the altered line. The 


line number is then printed again, giving another opportunity to 
alter the line. When OPTION NOVERIFY is selected, Edit does not 
print the altered line or offer another chance to alter the line. 
In this case, if another change is desired, ALTER must be 
reentered. A carriage return in the first character position 
will terminate ALTER. 


As soon as one line of characters is typed on a terminal, the 
line automatically wraps around to the next line. To alter the 
second part of a line, space through the first part of the line 
in order to access the second part. 
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The ALTER command is rejected in hexadecimal and batch mode. 


Examples: 


»T1-3 
L This text is part of a new document. 
2 The first thing we must do is revise it. 
3 This is an example of a long line that wraps 
around when it is displayed. 
»AL 1 
1 This text is part of a new document. 
1 > old 
L This text is part of a old document. 
1 > n 
1 This text is part of anold document. 
lL > % 
l This text is part of an old document. 
> %fone / 
L This text is one part of an old document. 
1 > 
»AL 2 
2 The first thing we must do is revise it. 
2 > too@eeee 
2 The first thing toodo is revise it. 
2 > 
2 The first thing to do is revise it. 
2 > 
»AL 3 
3 This is an example of a long line that wraps 
around when it is displayed. 
3 > 
> printe@e 
3 This is an example of a long line that wraps 
around when it is printed. 
3 > 


Assume the terminal is sysgened with the BIOC driver, 


BIOC is enabled. 
indicated by 


>AP 


1 THIS IS A TEST. 
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and OPTION 


‘In the following examples, the cursor is 


>THIS IS A TEST. 


and the file consists of only one line. 


To delete the period, enter backspace or CTRL-H; line now looks 
like this: 


1 THIS IS A TESTS 


Now enter:, AND A GOOD ONE. The line looks like this: 


1 »>THIS IS A TEST, AND A GOOD ONE.#: 


Enter RETURN and Edit will prompt for the next command. The 
current line will not be redisplayed because it is exactly as it 
appears above. 


To change the AND to BUT: 


2AL 


1 THIS IS A TEST, AND A GOOD ONE.®: 


Enter CTRL-W 5 times: once for the period, then 4 times’ to 
backspace 4 words, leaving the cursor before the A in AND: 


1 >THIS 15 A TEST, 


To move the cursor forward to the A, enter CTRL-F or just SPACE 
once to overwrite the existing space. Now type: BUT. The line 
will look like this: 


tated 


1 >»THIS IS A TEST, BUT# 


You could hit RETURN at this point, leaving the line as you see 
rE: However, let's try an insert. Enter CTRL-A, then a space 
followed by NOT. The line now looks like this: 


1 >THIS IS A TEST, BUT NOT#A GOOD ONE. 
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Notice that the space at the cursor is shifted. right with the 
rest of the line as the characters are inserted. Now, hit RETURN 
and the cursor will “zoom" to the end of the line, restoring the 
remainder, before Edit prompts for the next command. 


To change BUT NOT back to AND: 


»AL 1 


1 >»THIS IS A TEST, BUT NOT A GOOD ONE 


Enter CTRL-] followed by a _ comma. The cursor will search 
backwards to the nearest comma: 


Be >THIS IS A TEST; 


BUT NOT A GOOD ONE. 


Now enter CTRL-F twice to position the cursor at the B in BUT. 
Hit CTRL-_ 4 times to delete BUT and the space which follows, 
leaving the cursor at the N in NOT: 


1 >THIS IS A TEST, #OT A GOOD ONE. 


Finally, enter AND overwriting NOT and hit RETURN. Edit will 
prompt for the next command. Enter: 


>TYPE 


1 >THIS IS A TEST, AND A GOOD ONE. 
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3.5 APPEND COMMAND 


The APPEND command enters data to a file from the command input 
device. 


Format: 
APPEND 
Functional Details: 


Enter APPEND to either create a new file or add data to an 
existing file. 


In an interactive environment, Edit prompts you for data by 
displaying line numbers. The first line of data entered is 
assigned line number 1. Subsequent line numbers are incremented 
by 1. The maximum lines allowed ina file is 99999. If data 
already exists, the new information is entered on the _ line 
following the last line of data. Tab settings are recognized, if 
set during the current editing session. 


In a batch environment, data is entered immediately following the 


APPEND command. Terminate data with the character string 
previously specified in the OPTION command. See Section 3.22. 


Examples: 


>AP 
1 >To create 
2 Ya new file 
3 Y»enter APPEND. 
4 » 
>TY 1l- 
1 To create 
2 a new file 
3 enter APPEND. 
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3.6 BEFORE COMMAND 


The BEFORE command inserts a new character string immediately 
before a user-specified character string in a line of data. 


Format: 


“(line no, 
BEFORE /string/newstr ing] / 


f 


Parameters: 


col 


newstr ing 


line no, 


Line non 


string, 
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(/string, / [col] 


line non 
/strings/ ai 


is a non-alphanumeric character delimiting a 
string. The blank, minus sign, comma, 
semicolon, and any character that appears’ in 
the string itself cannot be used. 


is a sequence of unique alphanumeric 
characters. The new string is inserted before 
this string. 


is a decimal number from 1 to 256 indicating 
the starting column location of string, and 
string.. 


is a sequence of unique alphanumeric 
characters to be inserted before the specified 
character string. 


is the line number or first line number of a 
range of lines where the newstring will be 
inserted before the specified string. 


is the ending line number of a range where the 
newstring will be inserted before the 
specified string. 


is a unique character string or first unique 
character string of a range that determines 
where in the file the newstring will be 
inserted before the specified string. 


is the ending unique character string of a 
range that determines where in the file the 
newstring will be inserted before the 


specified string. 


string, 


Functional Details: 


If the inserted string produces a line longer than the 
established line length, or the portion of text to the left of 
the truncate column is expanded, the following message is 


displayed if any non-blank characters are lost: 
!NON-BLANK CHARACTERS LOST 


Examples: 


>»BEFORE /DISC/FILE/2 


Before the character string DISC, insert the character 


string FILE in line 2. 


>BEFORE /DISC/FILE/2-/TAPE/ 


Before the character string DISC, insert the character 
string FILE from line 2 to the first occurrence of 


character string TAPE. 


>»BEFORE /DISC/FILE/2- 


Before the character string DISC, insert the character 
string FILE from line 2 to end-of-file. 
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3.7 BOTTOM COMMAND 


The BOTTOM command changes the current line’ pointer to 
line of the file. 


Format: 


BOTTOM 


Examples: 


aTY Le 
1 
2 
3 
>TY 1 
1 
> BOTTOM 
3 


The BOTTOM command 

changes the current line pointer 
to the last Line of the file. 
The BOTTOM command 


to the last line of the file. 
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the 


last 


3.8 CHANGE COMMAND 


The CHANGE command replaces a specified character string with new 


data. 


Format: 


CHANGE /oldstring/ [col], /newstring/ 


f 


Parameters: 


oldstring 


col 


newstring 
line no, 
Line nop 


string, 


\ no 
/string/ - 


f 


line no, _ NOn 
/string, / cor] /stx ings / - 


is a non-alphanumeric character delimiting a 
string. The comma, minus sign, blank, 
semicolon, and any character in the string 
itself cannot be used. 


is a unique character string to be replaced by 


the newstring. 


is a decimal number from 1 to 256 indicating 
the starting column location of the character 
string to be changed. 


is a unique character string which replaces 
the oldstring. 


is a line number or first line number of a 
range to be searched for the oldstring. 


is the ending line number of a range to be 
searched for the oldstring. 


is a unique character string or first string 
of a range that determines where in the file 
the oldstring will be replaced by the 
newstring. 
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string, is the ending unique character string of the 
range that determines where in the file the 
oldstring will be replaced by the newstring. 


col is a decimal number from 1 to 256 indicating 
the starting column location of string, and 
string,. 


Functional Details: 
When CHANGE is used, all occurrences of the oldstring are 
replaced by the newstring. 


If a tab character is contained within a string, it is treated 
the same as any character in the string. 


If the inserted string causes the line length to exceed the 
default, or the portion of data to the left of the truncate 


column is expanded, the following message is displayed if 
non-blank characters are lost: 


!NON-BILANK CHARACTERS LOST 
Examples: 
>CHANGE.READ.,.INPUT.,3- 
Change all occurrences of READ to INPUT, from line 3 


through end-of-file. 


>CHANGE ?READ? , ?INPUT?, 1-20 


Change all occurrences of READ to INPUT, from line 1 
through line 20. 


>CHANGE.READ.,. .,1>- 


Change all occurrences of READ to a space, from line 1 
to end-of-file. 
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3.9 COLUMN COMMAND 
The COLUMN command replaces data beginning at a specified column 


with a new character string. 


Format: 


\ no 
/string/ [col]): 


i no, pens NOn 
/string,/ = /string,/ 7 


COLUMN col no,/string/|, 


Parameters: 


col no is a decimal number from 1 to 256 specifying 
the beginning column where data is to be 
replaced. 

J is a non-alphanumeric character delimiting a. 
string. The comma, blank, minus”~ sign, 


semicolon, and any character that appears’ in 
the string itself cannot be used. 


string is a sequence of alphanumeric characters, 
specified by delimiters, that replaces the 
Gata beginning at the specified column. 


Line no, is the line number or first line number of a 
range of lines where data will be replaced at 
the specified column. 


Line non is the ending line number of a range where 
data will be replaced at the specified column. 


string, is a unique character string or the first 
string of a range that determines where data 
will be replaced ina file. 


strings is the ending unique character string of a 


range that determines where data will be 
replaced ina file. 
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col is a decimal number from 1 to 256 indicating 
the starting column location of string, and 
string,. 


Functional Details: 


If the inserted string produces a line longer than the 
established line length, or the portion of text to the left of 
the truncate column is expanded, the following message _ is 
displayed if non-blank characters were lost: 


!NON-BLANK CHARACTERS LOST 
Examples: 


>COL 16,/R3/ 


Change the data starting in column 16 to the character 
string R3 in the current Line. 


>»COL 10,/LH/,1-20 
Change the data starting in column 10 to the character 
string LH, in lines 1 through 20. 

>»COL 15,/A2B/,/A1B/-/A5B/ 
Change the data starting in column 15 to the character 
string A2B, from the line containing the character 


string AlB to the line containing the character string 
A5B. 


»COL 5,/DISC/,-/FILE/ 
Change the data starting in column 5 to the character 


string DISC, from the current line to the line 
containing the character string FILE. 


>COL 5,/DISC/,- 


Change the data starting in column 5 to the _ character 
string DISC from the current line to the end-of-file. 
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3.10 DELETE COMMAND 


The DELETE command deletes data froma file. 


Format: 


Line no, Line non 
DELETE - 
/string, / [col] /strings/[col] 


1 


Parameters: 


Functional Details: 


line no, is the line number or first line number of a 
range to be deleted. 

Line noy is the ending line number of a range of data 
to be deleted. 

/ is a non-alphanumeric character delimiting a 
string. The comma, blank, minus” sign, 
semicolon, and any character appearing in the 
string itself cannot be used. 

string, ig a unique character string or first unique 
character string of a range that determines 
where data will be deleted in a file. 

strings is the ending unique character string of a 
range that determines where data will be 
Geleted ina file. 

col is a decimal number from 1 to 256 indicating 


the column location of string, and string,. 


The Line(s) specified by the operand(s) is(are) deleted from the 
- If no operands are specified, the current line is deleted. 
After one or more lines are deleted, the new current Line will be 
printed if the VERIFY option is enabled. 


file 
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If all lines of data are deleted, the following message is 
displayed: 


ALL LINES DELETED 


The DELETE command cannot be re-executed by entering the AGAIN 


command. 


Examples: 


»DELETE 10-20 


Delete lines 10 through 20. 


>DELETE 


Delete the current line. 


>DELETE - 


Delete all data from the current line to the 
end-of-file. 


»DELETE 20- 


Delete line 20 through the end-of-file. 


)DELETE /LPR/-/ACC/ 


Delete all lines, from character string LPR to character 
string ACC. 


The editor starts searching for the specified character 
string at the current line and continues, if necessary, 
to the end-of-file. Therefore, the current line must be 
numerically less than or equal to the line containing 
the character strings to be deleted. 


»DELETE /LPR/2-10 


Delete all lines, from character string LPR beginning in 
columm 2 through line 10. 
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3.11 DONE COMMAND 

The DONE command saves the current file 
session. 

Format: 


DONE 


Functional Details: 


and 


ends 


the editing 


This command is equivalent to a SAVE* followed by an END command. 
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3.12 END COMMAND 
The END command ends the editing session and returns control to 
the operating system. 
Format: 

END 
Functional Details: 
Edit goes to end-of-task with a code of 0 to indicate normal 
termination. 
If data was not saved before the END command is’ entered, the 
following command is displayed: 


REMINDER - SAVE YOUR CURRENT TEXT 


The END command cannot be re-executed by entering the AGAIN 
command. _ 
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3.13 FIND COMMAND 
The FIND command searches for all occurrences of a _ specified 


string in a given range of a file and displays them to the list 
device. 


Format: 


line no 
Ve, ing/[co i” 


line no, fers Non 
a ing, / [co F /string,/[col]) } ) 


FIND /string/[col] |, 


Parameters: 


/ is a non-alphanumeric character delimiting a 
string. The comma, blank, minus” sign, 
semicolon, and any character appearing in the 
string itself cannot be used. 


string is a sequence of alphanumeric characters 
specified by delimiters, to be searched for. 


col is a decimal number from 1 to 256 indicating 
the starting column location of the specified 
string. 

Line no, is the line or first line number of a range of 


lines to be searched for all occurrences of 
the specified character string. 


line non is the ending line number of a range to be 
searched for all occurrences of the specified 
character string. 


string, is a unique character string or first unique 
character string of a range that determines 
where in the file to search for the specified 
character string. 


string, is the ending unique character string of a 


range that determines where’ in the file to 
search for the specified character string. 
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col is a decimal number from 1 to 256 indicating 
the starting column location of string, and 
string. 


Functional Details: 


If a tab character is contained within a string, it is treated as 
just another character in that particular string. 


Examples: 


>FIND/SCH/, 1- 
Find every occurrence of the character string SCH, 
begining in line 1 through end-of-file. 

>FIND/SCH/1,5-7 


Find every occurrence of the character string SCH, 
beginning in column 1 from lines 5 through 7. 


>FIND /SCH/, /ACC/2-/CCA/2 
Find every occurrence of the character string SCH, 


beginning at the location of string ACC in column 2 and 
ending at the location of string CCA in column 2. 


>FIND /SCH/,-/CCA/2 


Find every occurrence of character string SCH, beginning 
at the current line and ending at the location of string 
CCA in column 2. 
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3.14 GET COMMAND 


The GET command brings a file off disc and readies it for 
editing. 


Format: 
GET fad 
Parameters: 


fd is the file descriptor of the file being 
accessed. 


Functional Details: 


When a GET command is entered, a copy of the specified file is 
brought off disc. It is now opened for editing and data can be 
added, deleted, inserted, changed, etc. Not until a SAVE command 
is entered, does the updated version of the file replace the 
original version. If a GET command is entered before the current 
data is saved, a reminder to save your current text is displayed. 
The GET command is not re-executed by entering the AGAIN command. 


If the record length of the fd is different from the current line 
length, the lines of data are expanded or decreased, accordingly, 
when they are output. When records are expanded, they are padded 
with blanks for ASCII mode. The pad character in hex mode is 
X'OO'. 


If OPTION LENGTH was issued prior to the GET command, and the 


physical length of the input file is larger than the specified 
line length, the following message is displayed: 


FILE RECORD LENGTH=m, CURRENT LINE LENGTH=n 


The variable m is the record length of the input file that was 
established when the GET command was issued. The variable n is 
the line length specified by the user via the OPTION command. 


In a batch environment, the program terminates. In an 
interactive environment, the message is informative only. 
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When the editor is executed as a foreground task, only files with 
account number O can be accessed. 


Example: 


»GET CH1EDT.008 


Get file CHLEDT.008 on the default user volume. 
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3.15 


HELP COMMAND 


The HELP command prints out information on how to use Edit. 


Format: 


MeL | 


Parameters: 


mnemonic 


Functional Details: 


mnemonic 


x 


] 


is any valid Edit command mnemonic. 
Information will be displayed on how to use 
the command associated with the mnemonic 
specified. 


causes a list of all Edit commands to be 
displayed. 


The HELP file must be on the default system volume under = account 


0. 


If parameters are omitted, Edit prints out information on how to 
use the HELP command. 


Examples: 


>HELP CH 


Displays to the user information on the CHANGE command. 


»HELP INS 


Displays to the user information on the INSERT command. 
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3.16 INCLUDE COMMAND 


The INCLUDE command copies a line or range of lines of data to a 
specified place ina file. 


Format: 


INCLUDE f 


Parameters: 


line no 


string 


fd 
line no, 


line no, 
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(Line no 1 ra 


lystr ing/ [col] 


no 
/string/ [col] 


i 


Line no, line non 
/string, /[col]). fai ing, / 7) 


is the line number after which data will be 
included. If this parameter is omitted, the 
Gata will be included immediately following 
the current line. 


is a unique character string which determines 
where in the file data will be included. 


is a non-alphanumeric character delimiting a 
string. The comma, blank, minus” sign, 
semicolon, and any character that appears’ in 
the string itself cannot be used. 


is the file descriptor of the file containing 
the lines to be included. If this parameter 
is omitted, the current file is the default. 


is the line number or first line number of a 
range of lines to be inserted after the 
specified line number. 


is the ending line number number of a range of 
line numbers’ to be inserted after the 
specified line number. 


string, is a unique character string or first unique 
character string of a range that determines 
the lines to be inserted after the specified 
Line number. 


string, is the ending unique character string of a 
range that determines the lines to be inserted 
after the specified line number. 


col is a decimal number from 1 to 256 indicating 
the starting column location of a character 
string. 


Functional Details: 


If the specified range is null, and the fd is omitted, the 
current line is inserted. If the range is null, and fd is 
specified, the first line of the specified fd is inserted. 

The lines are not deleted from their original place in the file. 
The inserted lines are assigned the Line number they are inserted 
after, incremented by .01. Incrementing stops when the new line 


number equals the last existing line number. The last line 
number generated is then used for all subsequent lines inserted. 


Examples: 


>INCLUDE 2, ,20- 


Include after line 2, lines 20 through the last line of 
the current file. 


»>INCLUDE 2,TRY.EDT,1- 


Include after line 2, all lines of a file named TRY.EDT. 


> INCLUDE, , 25-45 


Include after the current line, lines 25-45 of the 
current file. 


2 INCLUDE,TEXT 100-200 


Include after the current line, lines 100 through 200 of 
the file named TEXT. 
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> INCLUDE .END.7, TEXT, 1- 


Include, following the Line containing END in column 7, 
all lines of the file named TEXT. 


YINCLUDE 2,TEXT, /BEGIN/2-/END/4 


Include, after line 2 from the file named TEXT, all 
lines from the line containing the character string 
BEGIN in column 2 to the line containing character 


string END in column 4. 
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3.17 INSERT COMMAND 
The INSERT command inserts one or more new lines of data into a 
file. 


Format: 


Line no 


INSERT| < /string/ [col] 


Parameters: 

Line no is the line after which data is to be 
inserted. If line number is omitted, the data 
will be inserted after the current line. 

/ is a non-alphanumeric character delimiting a 
string. The comma, blank, minus”~ sign, 
semicolon, and any character in the string 
itself cannot be used. 

string is a unique character string that determines 
where in the file data will be inserted. 

col is a decimal number from 1 to 256 indicating 


the starting column location of the specified 
character string. 


Functional Details: 


When the user enters the INSERT command interactively, the editor 
displays the next fractional line number and a prompt, to 
indicate that a line of data can be entered. Line numbers are 
displayed in increments of .01, following the line specified by 
the line parameter. Incrementing stops if the new line number 
equals the next existing line number. The last line number 
generated is then used for all subsequent lines inserted. 


In a batch environment, input immediately follows the INSERT 


command. The data is terminated by a character string specified 
in the OPTION command. 
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Examples: 


»TY 1- 

1 This is an 

2 example of 

3 INSERT command works. 
»ins2 

2.01>how the 

2.02) 
»TY 1- 

1 This is an 

2 example of 

2.01 how the 

3 {[NSERT command works. 
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3.18 LINE NUMBER COMMAND 


Entering a line number by itself can display, replace, or insert 
a line of data. 


Format: 
n [data] 
Parameters: 
n is a line number. 
data is the data to be inserted or replaced. 


Functional Details: 


Entering a Line number, followed by data, causes that data to be 
inserted if the line number does not exist. If the line number 
exists, the new data replaces the original data. If a line 
number is specified followed by a CR, that line of data is 
displayed. The command is not re-executed by entering the AGAIN 
command. In a batch environment, the terminator string specified 
in the OPTION command replaces the CR. 


Examples: 


»2 Display line 2. 

»2 ABCD Replace data on line 2 with ABCD. Line 2 is 
now the current line. 

»2.01 EFGH Insert Line 2.01 after line 2 with the data 
EFGH appearing on it. 

>»0.01 EFGH Inserts a line containing character string 
EFGH on the line preceding the first line of 
a file. After the file is saved and 
renumbered, the line containing character 
string EFGH becomes the first line of the 
file. 
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3.19 MOVE COMMAND 


The MOVE command moves a line or range of lines of data within a 


file. 


Format: 


line no 
MOVE 


/string/ eon | 


Line no 
ae ing/ kal 


line no, (line non 
Soe daaeel ee | 


’ 


Parameters: 


line no 


string 
line no, 


Line non 


string, 


strings 
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is the line number after which lines of data 
are to be moved. 


is a non-alphanumeric character delimiting a 
string. The comma, blank, minus” sign, 
semicolon, and any character within the string 
itself cannot be used. 


is a unique character string indicating where 
in the files data is to be moved. 


is a line or first line number of a range to 
be moved after the specified line number. 


is the ending line number of the range to _ be 
moved after the specified line number. 


is a unique character string or first unique 
character string of a range that determines 
the lines to be moved. 


is a unique character string or ending string 
of a range that determines the lines to be 
moved. 


col is a decimal number from 1 to 256 indicating 
the starting column location of a character 
string. 


Functional Details: 


After the lines are moved, the original lines of data are 
deleted. The moved lines are assigned the same line number as 
the line they are inserted after, incremented by .Ol. 


Examples: 


»MOVE 4, 2-3 


After line 4, insert lines 2 through 3. Lines 2 through 
3 are deleted from their original place in the file. 


>»MOVE 4, /DISC/-/FILE/ 


After line 4, insert the lines beginning with the _ line 
containing the character string DISC to the line 
containing the character string FILE. The Lines 
identified by the specified character strings are 
deleted from their original place in the file. 


»>TY 1- 
L This is an 
2 example of 
3 MOVE command works. 
4 how the 
»MOVE 2,4 
>TY 1- 
nf This is an 
2 example of 
2.01 how the 
3 MOVE command works. 
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3.20 NOFIND COMMAND 
The NOFIND command searches for all lines in which a_ specified 
string does not appear. 


Format: 


NOFIND /string/ [col] 


line no 
7 ing/ — 


Line no, fees non 
Net ing, / voi | /strings/ aia 


’ 


Parameters: 


/ is a non-alphanumeric character delimiting a 
string. The comma, blank, minus” sign, 
semicolon, and any character appearing in the 
string itself cannot be used. 


string is the unique alphanumeric character string to 
be searched for. 


Line no, is a line number or first line number of a 
range to be searched for the _ specified 
character string. 


Line nop . is the ending line number of a range to be 
searched for the specified character string. 


string; is a unique character string or first unique 
character string of a range that determines 
the lines to be searched for the specified 
character string. 


string, is the ending unique character string of the 
range that determines the lines to be searched 
for the specified character string. 


col is a decimal number from 1 to 256 indicating 
the starting column location of a character 
string. 
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Functional Details: 


If the string occurs in every line specified by the line number 
parameter, the following message is displayed: 


?STRING OCCURS IN ALL LINES 


Examples: 


»NOFIND /DISC/,1- 
Find all lines where character string DISC does not 
occur, from lines 1 to end-of-file.- 

»NOFIND /DISC/5, 1-/FILE/ 
Find all lines where character string DISC, beginning in 


column 5, does not occur, from line 1 to the line 
containing character string FILE. 


»NOFIND /DISC/,/FILE/3-20 


Find all lines where character string DISC: does not 
occur, from the line containing character string FILE, 
beginning in column 3, through line 20. 
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3.21 NOTRUNCATE COMMAND 
The NOTRUNCATE command disables truncation if the TRUNCATE 
command was previously specified. 
Format: 
NOTRUNCATE 


Functional Details: 


Truncation is not in effect unless the TRUNCATE command is 
specified. Truncation is disabled when the NOTRUNCATE command is 
entered and the following message is displayed: 


TRUNCATE NOT IN EFFECT! 
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3.22 OPTION COMMAND 


The OPTION 


Format: 


OPTION 


command sets control options for a file. 


| 


commanp [=e] | BLOCK | =< 


yd 


tab char,col,[,colg,...,coln] 
TAB |=, EORTRAN 


(CAL, 


-xenacnaror| - 


ites: 


Cc oe aR oe ORI ee oe ee 


- nt] |) 
col; ,N 
Qn £ DOW 


ENFORCE \ 
WARNING 
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Parameters: 


COMMAND= 


BLOCK= 


MODE= 


LENGTH= 


LIST 


LOG 


NOTAB 


TERMINATOR= 


SCREEN= 


NOVERIFY 


VERIFY 
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fd is a file containing a command or a 
sequence of commands to be executed when the. 
fd is specified. There can be no more than 5 
nested editor command files. 


nis a decimal number from 1 to 255 which sets 
the data block size for allocated files. The 
default is 5. 


specifying HEXADECIMAL, sets the character 
format to hexadecimal. Specifying ASCII, sets 
the character format to ASCII. The default is 
ASCII. 


n sets the line length for data input and 
output. This value cannot exceed 256. The 
default value is 80 bytes or the record length 
of the file. 


fd assigns the list device to the specified 
fd. The default fd is the fd assigned in the 
START command. 


fd assigns the log device to the specified fd. 
The default is the fd assigned in the START 
command. 


cancels the Log option. 


tab char is a non-alphanumeric character used 
to set tabs for data formatting. The tab char 
is followed by a decimal number from 1 to 256 
specifying the columns where tabs are to be 
set. 


clears current tab settings. 


is a l- to 4-character alphabetic string used 
to terminate data input. Terminator can also 
equal a carriage return. 


n is a decimal number from 1 through 23 that 
sets the number of lines’ per screen to be 
displayed when the SCREEN command is’ entered. 
The default is 23 lines. 


cancels the verify option. Located, changed 
or altered lines are not output to the list 
device. 


causes data that was located, changed or 
altered to be output to the list device. If 
not specified, Verify is in effect. 


INPLACE= 


BIOC 


NOBIOC 


CONT INUE 


EXIT 


WINDOW 


ENFORCE 


WARN ING 


NOW INDOW 


ON causes all I/O operations that change a 
line of text to be performed directly to the 
Gisc file. If text currently exists in the 
edit buffer when this parameter is apecinied, 
the ON option is rejected. 


OFF causes all I/O operations that change a 
line of text to be performed on the text 
currently in the edit buffer. If neither ON 
nor OFF is specified, the default is OFF. 


enables BIOC editing and tabulation features 
descr ibed for the ALTER and OPTION TAB 
commands. This option is effective only if 
the terminal has been sysgened with the BIOC 
terminal driver. 


disables BIOC functions for terminals which do 
not use the BIOC driver. If neither BIOC nor 
NOBIOC is specified, the default is NOBIOC. 


causes the editor to continue execution in 
batch mode when’ some of the commands in the 
command file cannot be executed (e.g., RANGE 
NOT FOUND, STRING NOT FOUND). If this 
parameter is omitted, the default is EXIT. 


causes the editor to terminate execution when 
in batch mode and any one of the commands 
cannot be executed. If neither CONTINUE nor 
EXIT are specified, the default value is EXIT. 
When an unrecoverable error occurs’) during 
batch processing (I/O error), execution of the 
current job is halted regardless of the option 
setting. 


allows the user to specify a range of 
characters on each line that will be affected 
by the Edit commands. col,/coly are the start 
and end column settings that can range from 1 
to the maximum line length. The window size 
cannot exceed 68 characters and col; must be 
less than colo. col;,,N is the start columm 
setting and N is the size of the window. 
(e.g., Colg=col,+tN) 


only the characters within the range specified 
are affected by the Edit commands. 


the entire line is affected by the Edit 
commands and a warning is issued if the 
characters outside the window are affected. 


resets the window. 
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Functional Details: 


The OPTION command can be entered any time during an edit session 
while in command mode. Parameters can be entered on the same 
line, in any order, separated by commas. The editor processes 
them sequentially from left to right. If conflicting parameters 
are entered in the same statement, the last one specified is in 
effect. The editor displays current option settings if the 
command is entered with no parameters. 


When the command option is specified, if an end-of-file condition 
occurs when reading the command file, the following message is 
displayed: 


!END OF COMMAND FILE 


There can be no more than 5 nested editor command files. 


The block option sets the data block size for all subsequent file 
allocations. The block size is a decimal number from 1 to 255; 
the index block size is always 1. The value is used only whena 
file is allocated. At that time, if the block size specified 
exceeds the maximum system block size, allocation fails, and the 
following message is displayed: 


!IFILE ERR, LUn, SIZE ERROR, fd 


In the mode option, if ASCII is specified, all characters are 
interpreted in ASCII. If HEXADECIMAL is specified, all 
characters are interpreted as hexadecimal digits. Hex and ASCII 
modes are recognized for all Edit operations. When the editor is 
in hex mode, all data must be entered in hexadecimal. Valid hex 


characters are 0-9 and A-F. Special characters such as the 
Carriage return and tab character have no effects. The pad 
character in hexadecimal mode is X'OO'. The corresponding pad 
character in ASCII is ' '. The following is an example of hex 
editing: 

*EDIT 

>»O MO=HEX 

»AP 


L >01239FFACEDC88ACDCBB789EF55 
2 »>F FF FDDDDEEEE88992136553CDACCCEDF 
3 > 
>CH /DDDD/, /O000/, 2 
2 FFFFOOOOEEEE88992136553CDACCCEDFOOO0000000000000000000000 
000000000 


ASCII-EBCDIC conversion tables are presented in Appendix C. 
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When the tab option is in effect, data is expanded before it is 


stored. It remains in expanded form. The tab option entered 
with no arguments displays the current tab character and 
settings. Up to 20 tabulation points can be set. Once tabs are 
set, new tabs can still be inserted before the next highest 
setting. Column specification can be omitted to avoid changing 


both column and tab. 


When TAB=FORTRAN is specified, the editor sets tabs in columns 7 
and 73. Control I is the tab character. 


When TAB=CAL is specified, the editor sets tabs in columns 10, 
16, 36, and 73. Control I is the tab character. 


If the terminal is sysgened (with full BIOC support) with the 
BIOC driver and the BIOC functions are enabled (by OPTION BIOC), 
and if the tab character is Control I, then the tab positions 
will be "down-loaded" to the driver by the editor. The TAB key 
then causes the cursor to move to the appropriate position on the 


screen. The tabs will be expanded by the driver rather than the 
editor. 


NOTE 


A tab character will always cause the 
text to be tabulated to the next tab stop 
to the right of the current cursor 
position. For example, if option TAB=CAL 
is selected and the user tabs to column 
10 and types six characters (cursor is 
now in column 16), the next tab will 
cause the cursor to jump to column 36. 


When the BIOC option is disabled and text 
has been inserted past a tab stop, a_ tab 
character will cause the text to be 
tabulated one space instead of to _ the 
next tab stop. For example, if TAB=CAL 
is selected and the user tabs to column 
10 and types six characters (cursor is 
now in column 16), the next tab will 
cause the cursor to move one space, to 
column 17. 


The terminator option is generally used in batch environment to 
terminate data input. The terminator characters are positioned 
in columns 1-4 of the input line and are followed by blanks or a 
carriage return. In batch environment, when specifying a line 
number command to delete a line, the alternate terminator can 
directly follow the line number. TERMINATOR=CR specifies that a 
carriage return is the only valid terminator. 
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Any command that would cause the file to be expanded or 
contracted is disallowed while OPTION INPLACE is in effect. 
These commands are: 


@e APPEND 
@ DELETE 
e INCLUDE 
@ INSERT 
@ REPLACE 
e@ SAVE 


If any of these commands are issued when OPTION INPLACE is in 
effect, the following message is displayed: 


!INPLACE IN EFFECT - COMMAND DISALLOWED 


When the INPLACE option is not enabled, any commands that would 
cause a file to be expanded or contracted are allowed. 


OPTION BIOC enables special handling of the ALTER command and 
TABS. If the terminal has not been sysgened as a BIOC driver, 
this option has no effect. This option should be disabled when 
running the editor from the system console. 


The WINDOW option is operational only in ASCII mode. However, 
the mode is always reset to ASCII when the window is set and the 
window is reset when the mode is set to HEX. 


The WINDOW option and the TRUNCATE command cannot be set at the 
same time. 


Certain Edit commands are affected by the WINDOW option and now 
perform their functions as follows: 


SCREEN displays characters between col; and colo. 


TYPE displays characters between col; and cols. 
When ENFORCE is set and a string is specified, 
each line is searched between col; and colo. 
When WARNING is set, the entire line is 
searched and if the string is found outside 
the window, a warning is issued. Window 
settings are ignored when columns are 
specified by the TYPE command. 
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FIND 


CHANGE 


SUBSTITUTE 


ALTER 


APPEND 


AFTER 
BEFORE 


RULER 


3-42b 


when ENFORCE is set, each line is searched 
between col; and col 2. When WARNING is set, 
the entire line is searched and if the string 
is found outside the window, a warning is 
issued. Window settings are ignored when 
columns are specified by the FIND command. 


when ENFORCE is specified, only characters 
between col; and cols are affected. When a 
portion of the line between col; and col) is 
expanded or contracted, data outside of the 
window is not affected. Blanks are inserted 
to fill in the space when a string is 
substituted with a shorter string. When a 
string inside the window is substituted with 
a longer one, characters moved past col», are 


lost. When WARNING is specified, the entire 
line is affected and a warning is issued if 
changes are made outside of the window. 


Columns specified in the CHANGE command cause 
the window settings to be ignored. 


the same as the CHANGE command but only the 
first occurrence of the string is replaced. 


allows the user to modify text within the 
range specified by the WINDOW option. When a 
portion of the line between column settings is 
expanded or contracted, data outside of the 
window is not affected. Blanks are inserted 
to fill in the space when aé_=e string is 
substituted with a shorter string. When 
characters are inserted, all characters that 
are moved past cols are lost. 


the text typed in is actually moved to start 
at col; of the window. The beginning of the 
line is filled with blanks and the number of 
characters entered should not exceed the size 
of the window. 


when ENFORCE is specified, only a portion of 
the line between coli and col2 is searched for 
a user-specified string. When the new string 
is inserted, the characters moved past colo 
are lost. When WARNING is specified the 
entire line is searched and a warning is 
issued if changes are made outside of the 
window. 


the portion of the ruler within the window 
range is displayed to a list device. 
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Examples: 


2OPTION LENGTH=130 


Sets the line length for data entry and output to 130 
bytes per line. 


>OPTION BLOCK=10 


Sets the data block size to 10 for all subsequent file 
allocations. 


»>OPT ION 

Displays all values for current options. 
>OPTION LI=PR: 

Assigns the printer as the current list device. 
»>OPTION MODE 

Displays the current mode. 
2>OPTION MODE=H 

Sets the current mode to hexadecimal. 
2>OPTION TAB=§,5,10 


Assigns the $ as the tab character and the tab stops at 
columns 5 and 10. 


>OPTION TAB 
Verifies the tab character and settings. 
>OPTION TAB=$,15,TAB 


Adds a third tab setting to those already in effect and 
displays the tab options. 


»OPTION NOTAB 
Clears the current tab settings. 
»OPTION LOG=fa 


Logs all commands and messages to the file or device 
specified by fd. 


2>OPTION NOLOG 


Cancels the Log option. Commands and messages are not 
logged. 
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»OPTION TERMINATOR=END 


Defines END, in columns 1-4, as the alternate 
terminator. 


>OPTION VERIFY 


Displays the line modified by the CHANGE command to the 
log device. 


>OPTION NOVERIFY 

Cancels the Verify option. 
2>OPTION INPLACE=ON 

All changes are made directly to the disc file. 
2OPTION INPLACE=OFF 


All changes are made directly to the edit buffer. 


48-008 FO1 RO2 3-43 


3.23 PAUSE COMMAND 
The PAUSE command temporarily returns control to the operating 
system. 
Format: 
PAUSE 


Functional Details: 


To return to the editor, enter the CONTINUE command. The PAUSE 
command does not delete or change any data in the file, and the 
current line is unchanged. 
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3.24 REPLACE COMMAND 


The REPLACE command replaces existing lines of data with new 
information. 


Format: 
‘line no, “[T( line non 

REPLACE ae lies 

/string, /[col] /string,/[col] 
Parameters: 

line no, is the Line number or first Line number of a 
range to be replaced. 

Line non is the ending line number of a range to be 
replaced. 

/ is a non-alphanumeric character delimiting a 
string. The comma, blank, minus” sign, 
semicolon, and any character appearing in the 
string itself cannot be used. 

string, is a unique character string or first unique 
character string of a range that determines 
where in the file data is to be replaced. 

strings is the ending unique character string that 
determines where in the file data is to be 
replaced. 

col is a decimal number from 1 to 255 indicating 


the column location of string, and string,. 
Functional Details: 


In an interactive environment, the editor responds to a REPLACE 
command with a _ line number as the prompt. The first number is 
the line specified in the command. Succeeding lines are 
displayed in increments of .01. 


In a batch environment, input immediately follows the REPLACE 


command. The file is terminated by a specified string in the 
OPTION commana. 
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Examples: 


>REPLACE 4 


Allows the user to re-enter new data on line 4. 


>»TY 1l- 
1 This is an 
2 example of 
3 how the 
4 MOVE command works. 
»>REPLACE 
4 >REPLACE command works 
4.01) 
»TY 1l- 
1 This is an 
2 example of 
3 how the 
4 REPLACE command works. 
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3.25 RULER COMMAND 


The RULER command displays a ruler to the list device. 
Format: 
RULER 
Functional Details: 
You can enter the RULER command any time during command mode of 
an editing session. 
The ruler is output in hex, if OPTION MODE=HEX is specified in 


the OPTION comnand. 


Examples: 


>RULER 
1 2 3 4 5 6 
12345678901234567890123456789012345678901234567890123456789012345678 


>OPTION MODE=H 
> RULER 
0102030405060708090A0BOCODOEOF 101112131415161718191A1B1C1D1E1F 202122 


NOTE 
The actual line displays 69 characters 


when the prompt is enabled and 70 
characters when the prompt is disabled. 
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3.26 SAVE COMMAND 


The SAVE command outputs data to a file or device. 


Format: 


Parameters: 


fda 


x 


Line no, 


line non 


strings 


col 


line no 
a ing/ - 


i 


line no, line non 
/string, / a ie ing, / ail 


is the file descriptor of the allocated file 
to which the data is to be saved. 


saves new data to the current input file. 


is the Line number or first line number of a 
range to be saved. 


is the ending line number of a range to be 
saved. 


is a non-alphanumeric character delimiting a 
string. The comma, blank, minus”) sign, 
semicolon, and any character in the string 
itself cannot be used. 


is a unique character string or first unique 
character string of a range that determines 
the data to be saved. 


is the ending unique character string of a 
range that determines the data to be saved. 


is a decimal number from 1 to 256 indicating 


the starting column location of string, and 
string,. 
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Functional Details: 


If fd specifies a file that does not currently exist, an indexed 
file is allocated with the specified fd. If fd is the name of a 
file that currently exists, or is the name of the current input 
file, Edit displays the following message: 


DELETE AND REALLOCATE voln:filename/P? 


If the user indicates that the file should be deleted by entering 
YES, Edit deletes the file. If the file deleted was’ indexed, 
nonbuffered indexed or extendable contiguous, a file with the 
specified fd and attributes equal to the attributes of the file 
being edited is allocated. If a contiguous file was deleted, an 
indexed file with the specified fd is allocated. 


Current data is output to the allocated file. 
If the user indicates that the file should not be deleted by 
entering NO, Edit displays the following message: 


FILE NOT SAVED 


The editor did not execute the SAVE and outputs a command prompt. 


If a previously saved file is saved to an asterisk, or if fd is 
the name of the file being edited, the current data overwrites 


the current input file. The editor displays the following 
message: 


WORKF ILE=voln:f ilename/P 
RENUMBERED INPUT FILE AVAILABLE,voln:filename/P 


The data is renumbered and is available for further editing. 


When the fd or range parameter is omitted, the entire file is 
saved. To specify the lines of data to be saved, any combination 
of range arguments is permitted. Edit searches the file for the 
specified lines or character strings. After a match is made, the 
actual function of the command is performed. 


Data is saved beginning with the first line or string specified, 
continuing through the last line or string specified. 


To save only the current line, explicitly specify the current 
line number or a unique string in that line. 
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Examples: 


>»SAVE NEW.EDT 
Save all the lines to a file named NEW.EDT on the 
default volume. 

>SAVE NEW.EDT,1-10 
Save lines 1 through 10 to a file named NEW.EDT on the 
Gefault volume. 

>»SAVE M67B:NEW.EDT 
Save all the lines to a file named NEW.EDT on volume 
M67B. 

»SAVE* 


Save the current file to the same filename. 


>SAVE M67B:NEW.EDT, /ACC/2-/CCA/60 


Save all data from the line identified by -the first 
occurrence of character string ACC in column 2, to the 
line identified by character string CCA in column 60 to 
the file NEW.EDT on volume M67B. 
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3.27 SCREEN COMMAND 


The SCREEN command displays a full screen of data starting, 
ending, or centered at the current line. 


Format: 


Parameters: 


E displays a full screen of data ending at _ the 
current’ line. If this parameter is omitted, 
the default is S. 


Cc displays a full screen of data centered at the 
current line. If this parameter is omitted, 
the default is S. 


S displays a full screen of data starting at the 
. current line. 


Functional Details: 


If the SCREEN parameter was specified via the OPTION command, 
Edit displays only the number of lines specified by n. 
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3.28 SEND STOP COMMAND 
The SEND STOP command allows the user to halt execution of the 
current command. 


Format: 


SEND STOP 


Functional Details: 


The command is only valid during interactive use of the editor. 


The SEND STOP command is recognized when Edit is executing as a 
foreground task, is the current task, or is a terminal task under 
an MTM system. 


Enter SEND STOP in response to an operating system prompt. If 
Edit is currently outputting to the command device, depress the 
Break key to obtain the prompt. SEND STOP causes Edit to stop 
processing the command issued prior to SEND STOP. Edit is now 
ready to accept the next command. 
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3.29 SUBSTITUTE COMMAND 


The SUBSTITUTE command replaces a specified string of data with 
a new string of data. In a line of data only the first 
occurrence of the string is replaced using this command. , 


Format: 


line no, 
SUBSTITUTE /oldstring/newstr ing |/ 


/string, / [col] 
Line non 
eo ings / _ 


Parameters: 


/ is a non-alphanumeric character delimiting a 
string. The comma, minus sign, blank, 
semicolon, and any character in the string 
itself cannot be used. 


oldstring is a unique character string to be replaced by 
the newstring. 


col is a decimal number from 1 to 256 indicating 
the starting column location of the character 
string to be changed. 


newstr ing is a unique character string which replaces 
the oldstring. 


line no, is a line number or first line number of a 
range to be searched for the oldstring. 


Line non is the ending line number of a range to _ be 
searched for the oldstring. 


string; is a unique character string or first string 
of a range that determines where in the file 
the oldstring will be replaced by the 
newstring. 

strings is the ending unique character string of the 
range that determines where in the file the 
oldstring will be replaced by the newstring. 
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col is a decimal number from 1 to 256 indicating 
the starting column location of string, and 
string,. 


Examples: 


»SU /SUB/READ 
Change the first occurrence of the character string SUB 
to the character string READ in the current line. 

»SU .READ..1- 
Change the first occurrence of the character string READ 
to the null string from line 1 to end-of-file. 

»SU /SUB/READ//DISC/-/FILE/ 
Change the first occurrence of character string SUB to 


character string READ from the line containing character 
string DISC to the line containing character string 


FILE. 
2Ee 1 
Ra A*B=B*A 
2 B*A=A*B 
27SU /A/C/1-2 
ut C*B=B*A 
2 B*C=A*B 
»AGAIN 
1 C*B=B*C 
2 B*C=C*B 
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3.30 TOP COMMAND 

The TOP command changes the current line pointer to the first 
line of the file. 

Format: 


TOP 


Examples: 


»>TY 1l- 
1 The TOP command 
2 changes the current line pointer 
3 to the first line of the file. 
>»TOP 
1 The TOP command 
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3.31 TRUNCATE COMMAND 
The TRUNCATE command truncates a line of data at a specified 
column. 
Format: 
TRUNCATE [col no] 


Parameters: 


col no is the column number after which data is 
truncated. 


Functional Details: 


The specified column number becomes the point at which characters 
are lost when data to the left of this column is expanded (e.g., 
by substituting a longer string via the SUBSTITUTE command). 
Data to the right of the truncate column does not move when data 
to the left of the column is’ expanded. If any non-blank 
characters are lost (because they overflowed the truncate 
column), the following message is displayed: 


!NON-BLANK CHARACTERS LOST 


When blank characters are truncated, no message is displayed. 


If data to the right of the truncate column is expanded, 
characters are lost off the end of the line, the same as if 
truncate was not in effect. 


If the col no parameter is omitted and truncation is in effect, 
the value of the current column is displayed. If truncation has 


been disabled with a NOTRUNCATE command, the following message is 
displayed: 


TRUNCATE NOT IN EFFECT! 
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3.32 TYPE COMMAND 


The TYPE command displays lines of data to the list device. 


Format: 


line no, Line non 
aver |{ {| |. 
/string, / [col] /str ing, / [col] 


Parameters: 


Line no, is the line or first line number of a range of 
lines to be displayed to the list device. 


Line non is the ending line number of the range to be 
displayed to the list device. 


/ is a non-alphanumeric character delimiting a 
string. The comma, blank, minus’ sign, 
semicolon, and any character in the string 
itself cannot be used. 


string, is a unique character string or first unique 
character string of a range that determines 
what data is to be displayed. 


string, is the ending unique character string of a 
range that determines what data is to be 
displayed. 

col is a decimal number from 1 to 256 indicating 


the starting column of string; and stringo. 
Functional Details: 
When a string parameter is specified, Edit begins searching from 


the line following the current line. 


If the tab option is in effect, information is displayed 
appropriately. 
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Examples: 


>TYPE 10-20 


Display lines 10 through 20 of the current file. 


»TYPE 8 


Display line 8 of the current file. 


>»TYPE 20- 


Display lines 20 through the last line of the current 
file. 


>TYPE 


Display the current line. 


»TYPE - 


Display all lines from the current line through the last 
line of the current file. 


>TYPE/DISC/-/FILE/ 
Type all lines from the first occurrence of character 
string /DISC/ to the first occurrence of character 
string /FILE/. 

>TYPE/DISC/3-/FILE/60 
Type all lines from the first occurrence of character 


string /DISC/ in column 3, to the first occurrence of 
the character string /FILE/ in column 60. 
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3.33 PLUS SIGN COMMAND 


The plus sign (+) displays an increment of the current line of a 
file. 
Format: 

+ fy) 


Parameters: 


n is the increment of the current line to be 
displayed. [If this parameter is omitted, the 
default is the current line notl. 


Functional Details: 


If the line number parameter is greater than the number of lines 
in the file, then the last line of data is displayed along with 
the following message: 


LAST LINE 


Examples: 


>+ 2 Display the second line following the current 
line. 
>+ Display the line following the current line. 
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3.34 MINUS SIGN COMMAND 


The minus sign (-) displays a line preceding the current line of 
a file. 


Format: 
- [n) 
Parameters: 


n is the line preceding the current line to be 
displayed. If this parameter is omitted, the 
default is the current line number-1. 


Functional Details: 


If the line number parameter is greater than the number of 
preceding lines in the text, then the first line is output, along 
with the following message: 


FIRST LINE 
Examples: 
>- Display the line before the current line. 
>-4 Display the fourth line preceding the current 


Line. 
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CHAPTER 4 
SAMPLE EDIT SESSION 


The following Edit session was performed in an MTM environment 


that supports accounting. 


>»AP 
1 »The standard includes such tigh-performance features 
2 »as capacity for up to 3 of memory, 124 gemeral- 
3 >purpose registers, mjltilevel interrupt structure, 
4 »memory relocation and protection hardware along with a 
5 »8 megabytes/second direct memory access bandwidth, dynamic 
6 >comprehensive instruction set. 
7 2a host of performance instruction sets. 
8 2To complement the 3220's inherent power, Perkin-Elmer offers 
9 > 
>»BEFORE /includes/processor /1 
i The standard processor includes such tigh-performance features 
»AFTER /3/ megabytes/2 
2 as capacity for up to 3 megabytes of memory, 124 gemeral- 
»MOVE 6,8 
>»TY 5-7 
5 8 megabytes/second direct memory access bandwidth, dynamic 
6 comprehensive instruction set. 
6.01 To complement the 3220's inherent power, Perkin-Elmer offers 
7 a host of performance instruction sets. 


»SA ch4edt.008 

WORK FILE = M300:CH4EDT.000/P 

RENUMBERED INPUT FILE AVAILABLE, M300:CH4EDT.008/P 
>»GET CH4EDT.008 


*TY 1- 
1 The standard processor includes such tigh-performance features 
2 as capacity for up to 3 megabytes of memory, 124 gemeral- 
3 purpose registers, multilevel interrupt structure, 
4 memory relocation and protection hardware along with a 
5 8 megabytes/second direct memory access bandwidth, dynamic 
6 comprehensive instruction set. 
7 To complement the 3220's inherent power, Perkin-Elmer offers 
8 a host of performance instruction sets. 
»0 TA=/,29 
»O TA 
THE TAB CHARACTER IS / 
29 
>AP 


9 >Cache Memory/Writable Control Store 

10 »Memory Error Logger/Floating Point Processor 

11 »Battery Backup System/Data Handling Instructions 
12 > 
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l The standard processor includes such tigh-performance features 
2 as capacity for up to 3 megabytes of memory, 124 gemeral- 
3 purpose registers, multilevel interrupt structure, 
4 memory relocation and protection hardware along with a 
.5 8 megabytes/second direct memory access bandwidth, dynamic 
6 comprehensive instruction set. 
7 To complement the 3220's inherent power, Perkin-Elmer offers 
8 a host of performance instruction sets. 


9 Cache Memory Writable Control Store 
10 Memory Error Logger Floating Point Processor 
11 Battery Backup System Data Handling Instructions 
»TOP 
1 The standard processor includes such tigh-performance features 
>BOTTOM 
11 Battery Backup System Data Handling Instructions 


»SU /tigh/high/1 
1 The standard processor includes such high-performance features 
»COL 23,/4/,2 


2 as capacity for up to 4 megabytes of memory, 124 gemeral- 
>»9FI /gemeral/,1- 

2 as capacity for up to 4 megabytes of memory, 124 gemeral- 
»CH /meral/,/neral/ 

2 as capacity for up to 4 megabytes of memory, 124 general- 
>RE 

2 »aS Capacity for up to 4 megabytes of memory, 128 general- 

2.01> 
>»O MO=HEX 
»T 3 


3 707572706F 7365207 265676973 746572732C206D7 56C74606C6576656C20696E746572 
72757074207374727563747572652C2020202020202020202020202020202020202020 

>»SU /6D75/6D6A 
3 707572706F 7365207 265676973746572732C206D6A6C74606C6576656C20696E746572 
72757074207374727563747572652C2020202020202020202020202020202020202020 


>»O MO=A 
>INC 3,,5 
>»TY 1-6 
1 The standard processor includes such high-performance features 
2 as capacity for up to 4 megabytes of memory, 128 general- 
3 purpose registers, multilevel interrupt structure, 
3.01 8 megabytes/second direct memory access bandwidth, dynamic 
4 memory relocation and protection hardware along with a 
6 comprehensive instruction set. 
>INS 2 
2.01>as capacity for up to 4 megabytes of memory, 128 general- 
2.02> 
»TY 1-3 
1 The standard processor includes such high-performance features 
2 as capacity for up to 4 megabytes of memory, 128 general- 
2.01 as capacity for up to 4 megabytes of memory, 128 general- 
3 purpose registers, multilevel interrupt structure, 
»DEL 2.01 
>»TY 1-6 
1 The standard processor includes such high-performance features 
2 as capacity for up to 4 megabytes of memory, 128 general- 
3 purpose registers, multilevel interrupt structure, 
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4 8 megabytes/second direct memory access bandwidth, dynamic 


5 memory relocation and protection hardware along with a 
6 comprehensive instruction set. 
»COL 28,/o0/,9-11 
9 Cache Memory oWritable Control Store 
10 Memory Error Logger OF loating Point Processor 
11 Battery Backup System oData Handling Instructions 
»CH /O/,//,9-11 
9 Cache Memory Writable Control Store 
10 Memory Error Logger Floating Point Processor 
11 Battery Backup System Data Handling Instructions 
»SA * 


WORK FILE = M300:CH4EDT.000/P 

RENUMBERED INPUT FILE AVAILABLE, M300:CH4EDT.008/P 

»G ch4edt.008 

>»TY 1- 

The standard processor includes such high-performance features 
as capacity for up to 4 megabytes of memory, 128 general- 
purpose registers, multilevel interrupt structure, 

8 megabytes/second direct memory access bandwidth, dynamic 
memory relocation and protection hardware along with a 
comprehensive instruction set. 

To complement the 3220's inherent power, Perkin-Elmer offers 
a host of performance instruction sets. 

Cache Memory Writable Control Store 

Memory Error Logger High Performance Floating Point 
Battery Backup System High Speed Data Handling Instructions 


POWUOAN AO PWN 


aol aad 


> END 
MAUREEN -END OF TASK CODE= 0 CPUTIME=7.313/6.777 


48-008 FOO RO2 


APPENDIX A 
COMMAND SUMMARY 


/string, / [col] 


| en ina, ua 


line no, 
AFTER /string/newstring| / 


AGAIN 


b 

\\ 

ALTER [line no, ] [- [line non] | Je 
% 


pe7eteang? 
x 
APPEND 
Line no, 
BEFORE /string/newstring| / 
/string, / [col] 
Ve, NOn 
/string, / eae 
BOTTOM 
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CHANGE /oldstring/ [col] ,/newstring/ 


a no 
/string/ sii 


{ns no, Non 
/string, / cor) /string,/ aoa 


no 
/string/ [col] 


COLUMN col no,/string/|, 
nes no, pane NOn 
/string,/ = /string,/ aie 


line no, Line nop 
/string, / [col] /string,/ [col] 


DONE 


END 


line no 
8 ing/ - 


Line no; fers Non 
‘ans ccsiailt /string,/[col] 


FIND /string/ [col] |, 


GET fd 


mnemonic 
HELP 
x 
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INCLUDE ins _ ) [td] 


/str ing/ [col] 
line no 
“ ing/ — 
Line no, ‘Line non | 
Mec ing, / sail ; ers ing, / [col] q 
line no 


INSERT | < /string/ [col] 


line no 
MOVE . 
/string/ [col] 
line no 
1 ae, ing/ nual 


ie no, — non 
/str ing, / nied /string, / ott 


NOFIND /string/ [col] 


line no 
etx ing/[col] 


line no, ee non 
yet, ing, / [col] /strings/ [col] 


NOTRUNCATE 
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tab char,col, [,col,,...,coln] 
TAB |=( FORTRAN | 


“s CAL. 


oe eee 


PAUSE 


line no, line no, 
REPLACE i = 
/string,/[col ] /string,/[col ] 


ROLER 


no 
7 an aapiiastl 


yore no4 nee NOp 
/string, iat | /str ing, /{col] q 
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SEND STOP 
line no, 
SUBSTITUTE /oldstring/newstring|/ 
/string, /[col ] 
ne non ; 
eager: 
TOP 


TRUNCATE [col no } 


line no, line non 
TYPE =A 
/string, /[col] /string, /[col ] 


+ [nr] 
~ [n] 


on [data ] 
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APPENDIX B 
MESSAGES 


!!tFILE ERR,LUN,SIZE ERROR, fd 


The specified block size exceeds the system maximum data 
block size. 


!!I/O ERR, LUn, code, fd 


n is the logical unit (lu) number. 
code is the error code. See Table B-1l. 
fd is the file descriptor. 


TABLE B-1 SVCl ERROR CODES 


| ERROR CODE | MEAN ING 
leone emer ree ee eee Rite sre ee er Seer Se Se ST SSS SS 
| HHS eer rrerer esse ees 
X'81' ILLEGAL OR UNASSIGNED LU 
X'82' PARITY OR RECOVERABLE ERROR 
X'84' UNRECOVERABLE ERROR 


' ' 
' ' 
{ X'88' | END OF FILE 
' i 
i i 


x'90' END OF MEDIUM 
X'AO' DEVICE UNAVAILABLE 
X'CO' ILLEGAL FUNCTION 


!!IFILE ERR, LUn, code, fd 


n is the lu number. 
code is the error code. See Table B-2. 
fda is the file descriptor. 
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TABLE B-2 SVC7 ERROR CODES 


— ee ee ee ee es ee ee ee ee ee ee oe oe 


i ERROR CODE |} MEAN ING 
Ol | ILLEGAL FUNCTION 1 
H 02 | LU ERROR | 
{ 03 | VOLUME ERROR H 
H 04 | NAME ERROR 
05 | SIZE ERROR 
06 {| PROTECT ERROR 
07 | PRIVILEGE ERROR 
i 08 i BUFFER ERROR 
09 i ASSIGNMENT ERROR 
H OA | TYPE ERROR i 
i OB | FILE DESCRIPTOR ERROR | 
H oc | TGD ASSIGNMENT ERROR |} 
H OD | ACCOUNT ERROR 


ALL LINES DELETED 


All lines were deleted from a file using the DELETE command. 


?COL # WITHIN STRING OPERAND INVALID HERE 


A column was specified where it is not allowed in the command 
format. 


?COLUMN INCORRECT 


A column was specified where it is not allowed in the command 
format. 


?COMMA MISSING 


A comma was missing in the command syntax. 


?COMMAND NOT RECOGNIZED 


The command mnemonic was entered incorrectly. 


!COMMAND LEVELS NESTED TOO DEEP 


Command level exceeds that supported by program. 
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DELETE AND REALLOCATE VOLN: FILENAME /P? 


The file specified in the SAVE command already exists or is 
the name of a current input file. Enter YES if the file is 
to be deleted and reallocated. Enter NO if the file is not 
to be deleted and reallocated. 


{END OF COMMAND FILE 


END 


END 


END 


An EOF condition occurred while reading a command file. 


OF TASK CODE=0 


Normal completion of a job. 


OF TASK CODE=1 


Abnormal job termination as a result of invalid START 
arguments. 


OF TASK CODE=2 


Execution was terminated as a result of an error encountered 
in batch processing. 


?F ILE NOT FOUND 


The file was not found on the specified volume or the default 
volume. 


FILE NOT SAVED 


NO was entered in response to the DELETE AND REALLOCATE 
message. 


?F TLENAME INCORRECT 


The filename was entered incorrectly. 


!FIRST LINE 


The line number specified exceeds top-of-file. 


HELP FILE FORMAT ERROR - ABORTED 


The Help file format is incorrect. 
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HELP FILE NOT FOUND 


The Help file was not found in the system volume under the 
system account. 


{INVALID BLOCK SIZE 


The specified block size is not in the range allowed. 


2? INVALID COLUMN SPECIFIER 


The specified column number is invalid. 


2? INVALID HEX CHARACTER 


The specified character string contains an invalid hex 
character. 


!INVALID LIST DEVICE 


The fd specified in the list command cannot be assigned. The 
original assignment is in effect. 


{INVALID SEND MESSAGE 


An invalid parameter was entered during a send sequence. 


! INVALID TRUNCATE VALUE 


An invalid value was specified for the truncate column. 


! INVALID OPERAND 
The parameter specified in the SCREEN command is not one of 
'S', "ET, or 'C', 

!FTLE RECORD LENGTH=m CURRENT LINE LENGTH=n 


The record length of the file specified when a GET command 


was issued, exceeds the length specified in the OPTION LENGTH 
command. 


{LAST LINE 


The number specified results in going to end-of-file. 


B-4 48-008 FOO RO2 


{LENGTH OPTION NOT ACCEPTED 


The length option was specified after the GET command. 


!LINE NOT FOUND 


The line or string after which data is to be inserted could 
not be found. 


?LINE OPERAND INVALID 


The specified line number is invalid. 


!NON-BLANK CHARACTERS LOST 


The replacement character string exceeds the default number 
of characters per line. Non-blank characters are truncated. 


INO TEXT 


An Edit command was entered before a file was. brought off 
disc via the GET command, or there was no data in the 
allocated file. 


?NUMBER INVALID 


The line parameter is not a numeric character. 


20CCURS IN ALL LINES 


When executing the NOF IND command, the specified character 
string to be searched for was found in all lines. 


!OPTION ERROR FOLLOWS XXXX 


The characters appearing in place of xxxx are the last four 
non-blank characters recognized as valid. An OPTION 
parameter was not valid. 


{RANGE 1 NOT FOUND 


The lower limit of the range could not be found. 


!RANGE 2 NOT FOUND 


The upper limit of the range could not be found. 
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?RANGE INVALID 


The specified range was entered incorrectly. 


!REMINDER - SAVE YOUR CURRENT TEXT 


An END or another GET command was entered before entering a 
SAVE of current data. . 


?REPEAT DISALLOWED 


The DELETE, END, GET commands, and a line of data _ entered 
with a line number are not re-executed by entering a carriage 
return. 


!SCREEN SIZE INVALID 


The number of lines specified for screen size is invalid. 


?STRING [NVALID 


The specified character string was entered incorrectly. 


{STRING NOT FOUND 


Character string not found within the specified range. 


{TAB ILIEGAL 


An illegal tab setting was specified, or an illegal tab 
character was used. 


!TABS TABLE FULL 


There are more than 20 tab settings. 


TEXT IN BUFFER, CANNOT SWITCH TO INPLACE 


Text currently exists in the buffer. ON option rejected. 


!'TRUNCATE NOT IN EFFECT 


The NOTRUNCATE command disabled truncate. 
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!'TRUNCATE VALUE INVALID 


There is an invalid value specified for the truncate column. 
?UNABLE TO LIST FULIL SCREEN 


There is insufficient data in the file to list a full screen 
as requested in the SCREEN command. 
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APPENDIX C 
- EBCDIC CONVERSION TABLES 


ASCII 


Ce ee ee nal ee Re A ln ee ene ee A re a en a en ee nea 


CARD 


PUNCHES 


CHARACTER 


Uppercase Letters 


ANMAHMUOKARDANMHTNUORAN 

t' t rt £ t Ft t Ff bt tb ft Pt br inn rFrnwor an 
NANNNANNNANN De etd di dt stat ttl tl dc 
AdticdtdtAt dt aA Adi ni nn AAA Ai AAOCOOCOCOoOoCoocOo 


HCMVUANHUITHHMHSEAZOMOMNHDOSOS KAN 


Lowercase Letters 


ANMNAMNUORAHANM 
WDDDMDADDADADADAARVA 
ANMNAMNUWONR ADEM U 
woonnwnnwnNnNWNVUNUWUWW 
- 
ANMSTINOR OD ! 
rtettdt t t tea 
qoo0ooooooodoe 


[i2z=-11l=2 
pil2zsli=3 


aAadaldtadtdddae 


SCQ0TOH DloOAnMKA 
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| ASCII {| EBCDIC |} 
' t 
' 


t t 

t I 

H i CARD erm G. de Ne ha ae el 
H CHARACTER | PUNCHES { HEXADEC IMAL H 
Nac he rae areca send ie | 
H Lowercase Letters H 
aa lala les a ea | 
H m j}12-11-4 6D | 94 
n ther Li-S 6E | 95 
re) {12-11-6 6F | 96 
{ p faZ2=1i=7 70 | 97 
H q }12-11-8 71s 98 
xr tee Lie9 72 | 99 H 
H s }11-0-2 73° I A2 
i t } 11-0-3 74 | A3 
u 1 11-0-4 75 4 A4 
Vv {}11-0-5 | 76 | A5 
{ w {11-0-6 77 | A6 
x |} LL-O-7 78 | A7 
H y | L1-0-8 79 | A8 H 
Zz 11L1-0-9 TA | A9 | 
a a | 
Numerals 
ae ae ee i sienna es ca ae eae Sg a oe 
0 i O 30 |} FO | 
} 1 i tL 31 |; Fl | 
} 2 i 2 32 | F2 | 
H 3 i 3 H 33 | F3 | 
4 i 4 H 34 ; F4 | 
H 5 i 5 H 35 | F5 | 
6 i 6 36 j Fo | 
H 7 i 7 H 37} F7 } 
{ 8 i 8 38 | F8 | 
9 i 9 { 39 | FQ | 
oS Sa eS SS eee ee ee i See ee es ee eo 
H Symbols H 
, eS ee aS SS a eS Se a oe ee a ee ee a ee 
{Exclamation point Yr {| Li-8-2 H 5D | 5A H 
iQuotation mark, H H H H 
idieresis " | 8-7 H 22 |} 7F H 
iNumber sign, pound sign # | 8-3 23 | 7B 
iDollar sign $ {11-8-3 24 =| 5B H 
iPercent sign % | O-8-4 { 25 | 6C H 
i Ampersand & {12 1 26 |} 50 
{Apostrophe, acute | H H H 
jaccent , |} 8-5 { 27 H 7D H 
{Opening parenthesis ( +12-8-5 H 28 | 4D H 
iClosing parenthesis ) {11-8-5 { 29 | 5D 
{Asterisk * {11-8-4 H 2A | 5C 
{Plus sign + {12-8-6 H 2B OCS 4E H 
iComma, cedilla i 0-8-3 { 2c | 6B H 
iMinus sign, hyphen = Pil H 2D | 60 1 
iPeriod, decimal point - {12-8-3 H 2E | 4B 
iSlash, virgule, solidus / ; O-1 H 2F | 61 1 
{Colon >: | 8-2 3A | TA 
iSemicolon ; {11-8-6 H 3B SC} 5E H 
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es ee ee ne oe ee) ee. VE ee eR em me ce wa mesh mins bene mam vey SEES SEED ee ee Se EO OD SE ee en es ere ee ee ees nee i ee ee 


H { | ASCII {| EBCDIC 
| H CARD [Aor eee eae 
H CHARACTER {| PUNCHES | HEXADECIMAL 

{ eee em eee cae ene nm anne) nem SIO im nO OnE) RD SED SOND ES MAD OOD OD om) em OS re OR Ge aS A Oe AOS SUED Ms OE i ein cane we ee ee me ee oes ee eee me me me ee 
Symbols 

H ecm nem mam me are ome ns es me wee moe comm mm wore ee ente ume amit mms om aime od wap amy fm mes cum ee em oom is la lk das, wai ca Sui sats aja sss a 
j{Less than < {12-8-4 3c Of 4c 
{Equal sign = | 8-6 H 3D} 7E 
iGreater than >» | O-8-6 3E Oj 6E 
iQuestion mark 2? | O-8-7 3F | 6F 
{Commercial at symbol @ }; 8-4 40 |} 7C 
{Opening bracket { {12-8-2 H 5B} 4A 
{Closing bracket ] {12-8-7 H 21 | 4F 
{Reverse slash \ | 0-8-2 { 5c | EO 
{Circumf lex A 4{11-8-7 H 5E | 5F 
{Under Line — | 0-8-5 { 5F sf 6D 
{Grave accent ‘ | 8-1 1 60 =| 79 
{Opening brace { } 12-0 H 7B Of co 
{Closing brace } } 11-0 1 7D | DO 
{Vertical Line oo eek H 7C 6A 
OvVEnT ENG: Eee “ } 11-0-1 H JE | Al 

H oe ca ct eee an mm a ae ean oan se en em os ine mam sem mm ch we tne es ki nee nin es oe cae ne ee ee ee ee ae ee ee site cote vee io cam nen cae nnn uae a nd each ame oe 
Nonpr intable Characters 

H seme se  Sa  n li lS im “a tae tin t's i io i eh abo hk ik sr hm a ei io a a ei: Am se mi hs ‘ 
{ACK (acknowledge) H 0-9-8-6 06 } 2E 
{BEL (bell) | .0=9=8=7 O7 | 2F 
iBS (backspace) ie “L196 08 | 16 
iCAN (cancel) ; Li1=-9-8 18 | 18 
iCR (carriage return) i} 12-9-8-5 OD } OD 
{DCl (device control 1) Pobieg-21 11 | 11 
iDC2 (device control 2) | -Ll-9=2 12 | 12 
i1DC3 (device control 3) PoLi=9=3 H 13} 13 
1DC4 (device control 4) i 9-8-4 H 14 |} 3C 
i|DEL (delete) | 12-9-7 H 7F | 07 
iDLE (data link escape) {| 12-11-9-8-1} 10} 10 
{EM (end of medium) } 11-9-8-1 { 19°} 19 
iENQ (enquiry) } O-9-8-5 { 05 |} 2D 
{EOT (end of transmission) | 9-7 H 04 |} 37 
{ESC (escape) | 0-9-7 H 1B SO} 27 
{ETB (end of transmission } H H 

{ block) | 0-9-6 H 17 | 26 
{ETX (end of text) {}12-9-3 03 | 03 
iFF (form feed) 112-9-8-4 oc |} oc 
iFS (file separator ) 111-9-8-4 H 1c} 1C 
IGS (group separator) 1} 11-9-8-5 1D} 1D 
(HT (horizontal tabulation) {12-9-5 O09 |} 05 
{LF (line feed) | 0-9-5 H OA } 25 
iINAK (negative acknowledge)} 9-8-5 H 15} 3D 
iINUL (null) j12-0-9-8-1 | oOo |} 00 
IRS (record separator) {11-9-8-6 H lE } LE 
iSI (shift in) {12-9-8-7 OF |} OF 
iSO (shift out) | 12-9-8-6 { OE | OE 
{SOH (start of heading) 112-9-1 Ol } 01 
iSP (space) i i 20 { 40 
iSTX (start of text) {}12-9-2 1 02 | 02 
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eR ee RS SG GE GS Oe SE Se SE ee ee ee See ee GS ee we ee ee ee es ee ee ee ee ee ee 


| | ASCII | EBCDIC | 
CARD | -------- -------- 
t 
' 


Q 
: 
Q 
ry 
| 
ys] 


{ 

' 

iSUB (substitute) | 9-8-7 H 1A so} 3F H 
iSYN (synchronous idle) i 9-2 H 16} 32 
{US (unit separator ) 1 11-9-8-7 H LF | LF H 
iVT (vertical tabulation) {12-9-8-3 { OB } OB H 


fee ee meee ANS CT mE SD SN TE OO ee SE OL OE SS Se St SED OE SE eS re me Sey SO OE ES om cae wre ue RE i UD OE LY Oe OE me eee me Cee Oe En OL OO 
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APPENDIX D 
BIDIRECTIONAL INPUT/OUTPUT CONTROL (BIOC) 
FUNCTIONS APPLICABLE TO OS/32 EDIT 


Bidirectional input/output control (BIOC) is a standard 0S/32 
terminal driver. This appendix contains information about BIOC 
function control codes applicable to users of the OS/32 EDIT 
program. Listed are function control codes, standard control 
characters generated by the use of the codes, and the functions 
performed. 


On terminals that do not generate standard control characters for 
any of the function keys, it is necessary to determine which key 
will produce the required control characters in order to invoke 
a desired function. 


When a combination of control and ASCII keys cannot be accepted, 
BIOC rejects that combination and responds with a bell code. An 
example of this is the use of CTRL-H if attempted at the first 
character position ina line. 


ASCII control characters for BIOC are not echoed (displayed to 
the console) to prevent confusion between BIOC functions and 
terminal functions. 


For a complete list of BIOC functions available, see the 
Multi-Terminal Monitor (MTM) Reference Manual. 


CTRL-B (STX) Backspace (Nondestructive) 


This code causes the cursor to backspace one character each time 
the code is used. To be effective, CTRL-B cannot be entered at 
the first character position on a line. When the cursor has been 
backspaced to the desired character position, the line may be 
changed by typing the desired characters. All other characters 
backspaced over can be restored and the cursor brought back to 
the end of the line in one of two ways: 


e CTRL-F moves the cursor forward one character at a time. 


e CTRL-Z "zooms" the cursor immediately to the end of the line. 
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CTRL-C (ETX) Capture the Last Line Entered 


Entering this code causes the last line entered (maximum of 80 
characters) to be displayed on the console. By using CTRL-C 
repeatedly, character strings can be concatenated. If an insert 
or delete function is performed, the CTRL-C code is rejected and 
a bell sounds to remind you that the buffer has now been 
overwritten. 


CTRL-F (ACK) Forward Space and Restore 


This code is used to restore a line that has been backspaced over 
by the CTRL-B, CTRL-W, or CTRL-] code. After the cursor has been 
moved to the desired position and the correction has been made, 
CTRL-F moves the cursor forward one character position at a time 
until it reaches the end of the _ line. CTRL-F is rejected if 
there are no characters to be restored. 


CTRL-H (BS) Backspace (Destructive) 


This code is used to delete a character or characters. Unlike 
CTRL-B, however, any character(s) backspaced over by using the 
CTRL-H code cannot be restored by using the CTRL-F or CTRL-Z 
codes and must be retyped. If they are not retyped, blank spaces 
appear in those character positions. CTRL-H is rejected if 
attempted at the first character position in a line. On most 
terminals, the CTRL-H code can be generated by the “backspace” 
key. 


CTRL-L (FF) Set Page Pause Line Count 


To set the CRT screen display for a specific number of lines, the 
CTRL-L code is entered, followed by depressing the control key 
again with another ASCII character. The numeric value of the 
ASCII character sets the number of lines to be displayed. To 
select a count for a 24-line CRT, enter the sequence: CTRL-L, 
CTRL-X (CTRL-X has a decimal value of 24). 


The following table shows the proper combinations for line 
displays ranging from 1 to 24. 
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TABLE D-1 LINE DISPLAY 


COMB INATIONS 
{ {| NUMBER} 
{ SEQUENCE | OF LINES } 
| #2 cae ce eS Sec Ree = | 
{ CTRL-L CTRL-A |} 1 { 
{| CTRL-L CTRI-B | 2 H 
{ CTRL-L CTRL-C | 3 { 
{| CTRL-L CTRL-D | 4 H 
{| CTRL-L CTRL-E | 5 
| CTRL-L CTRL-F | 6 H 
{ CTRL-L CTRL-G | 7 
| CTRL-L CTRIL-H | 8 H 
{| CTRL-L CTREL-I | 9 
} CTRL-L CTRL-J } 10 
i CTRL-L CTRL-K }; 11 H 
| CTRL-L CTRL-L } 12 { 
i CTRL-L CTRL-M |} 13 i 
{| CTRL-L CTRL-N | 14 
i CTRL-L CTRL-O | 15 
{ CTRL-L CTRL-P } 16 
{| CTRL-L CTRL-Q } 17 
} CTRL-L CTRL-R } 18 H 
| CTRL-L CTRL-S } 13 H 
{ CTRL-L CTRL-T } 20 H 
| CTRL-L CTRL-U } 21 
| CTRL-L CTRL-V } 22 H 
;} CTRL-L CTRL-W | 23 H 
ij CTRL-L CTRL-X } 24 H 


Each display of the requested number of lines is terminated with 
a bell sound. At this point the user may continue to the next 
page by entering a carriage return (CR). This causes the same 
number of lines to appear; each CR, in fact, produces that number 
of lines until the page pause line count is changed. To change 
the count, terminate write by entering ESC or Break, and enter a 
different sequence for the desired new line count (e.g., CTRL-L 
CTRL-O = 15 Lines, etc.). 


To cancel the page pause mode, use the sequence CTRL-L CTRL-@. 
If the page pause mode is not terminated within 5 minutes, BIOC 
automatically continues output to prevent the terminal from being 
permanently tied up. 
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CTRL-M (CR) Terminate Read 


This function is a carriage return (CR). Entering CTRL-M 
indicates to BIOC that read should be terminated. If CTRL-M is 
entered at a location other than the end of the line, BIOC 
performs a zoom to the end of the line (EOL) before storing the 
CR and terminating the read request. 


CTRL-R (DC 2) Reprint Entered Line 


When this code is entered, the current cursor location within the 
line determines the number of characters that are reprinted on 
the next line. All characters to the left of the cursor, 
including blank spaces, are reprinted. 


The CTRL-R function is especially useful for: hardcopy terminals 
where corrections are made over the existing typed lines. To 
view a "clean" line after all corrections have been made, CTRL-R 
is used. 


CTRL-W (ETB) Word Backspace (Nondestructive) 


CTRL~-W causes the cursor to be backspaced (nondestructively) to 
the nearest nonalphabetic character. Thus, CTRL-W allows the 
cursor to backspace over one complete word, rather than one 
character, as with CTRL-B. Words backspaced over may be restored 
by the use of CTRL-F or CTRL-Z. CTRL-W is rejected if attempted 
at the beginning of a line. 


CTRL-X (CAN) Cancel Current Input Line 


All characters previously entered on the current line are deleted 
upon use of the code. Characters may not be restored with the 
CTRL-F or CTRL-Z functions. If no characters are on the line, 
CTRL-X is rejected. 


CTRL-Z (SUB) "Zoom" to Furthest End of Line 
CTRL-Z can be used to restore a line that has been backspaced 
over by CTRL-B, CTRL-W, or CTRL-]. CTRL-Z causes the cursor to 


"zoom" to the end of the line, but is rejected if there are no 
characters to be restored. 
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CTRL-] (GS) Backward Character Search (Nondestructive) 


This code serves to locate a specific character on the current 
line. For example, to find the character $, enter CTRL-]$. BIOC 
backspaces until the first $ is found. To find any additional 
dollar signs on the same line, the code must be entered again for 
each time the $ symbol appears. Characters backspaced over may 
be restored by using CTRL-F or CTRL-Z. CTRL-] will be rejected 
if attempted at the beginning of the line. 


CTRL-A (RS) Toggle Between Insert-on and Insert-off 
Each CTRL-A toggles from insert-on to insert-off or from 


insert-off to insert-on. When the insert mode is selected, 
characters typed are inserted to the left of the character 


currently at the cursor position. The insert mode may be 
selected only when the echo state is in effect and the cursor is 
positioned at a location other than end of the line. Insert mode 


is terminated by another CTRL-“A or by any command that moves the 
cursor to the end of line (e.g., CTRL-Z). The CTRL-C function is 
not valid while in the insert mode. All other functions are 
valid if the cursor is not in motion. All data entered while the 
cursor is in motion is ignored until the cursor has stopped. 


CTRL-_. (US) Delete Character 


Each CTRL-_ deletes the character currently at the cursor 
position. The delete code is valid only when the cursor is 
positioned at a location other than end of line. Characters 


entered while the cursor is in motion are ignored. 
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AFTER command, 3-2 
AGAIN command, 3-4 
ALTER command, 3-5 

APPEND command, 3-10. 

ASCII and hexadecimal editing, 1-4 
ASCII-EBCDIC conversion tables, C-1 
ASCII mode, 1-4 


Background task, 1-3 

Batch processing, 1-3 

BEFORE command, 3-11 

BIOC function applicable to Edit, D-1 
Block size, 3-39, 3-41 

BOTTOM command, 3-13 

Break key, 3-52 

Building Edit, 2-1 


Carriage return, 1-2, 1-8 
CHANGE command, 3-14 
Character strings, 1-5 
COLUMN command, 3-16 
Column display, 1-9 
Command 

files, 3-39, 3-41 

mode, 1-1, 1-2, 3-41 

prompt, 1-2, 3-49 


Commands 
AFTER, 3-2 
AGAIN, 3-4 
ALTER, 3-5 


HELP, 3-26 
INCLUDE, 3-27 
INSERT, 3-30 

LINE NUMBER, 3-32 
MINUS SIGN, 3-60 
MOVE, 3-33 
NOFIND, 3-35 
NOTRUNCATE, 3-37 
OPTION, 3-38 
PAUSE, 3-44 
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INDEX 


PLUS SIGN, 3-59 
REPLACE, 3-45 
RULER, 3-47 
SAVE, 3-48 

SCREEN, 3-51 
SEND STOP, 3-52 
SUBSTITUTE, 3-53 
TOP, 3-55 
TRUNCATE, 3-56 
TYPE, 3-57 


Command summary, A-1 


Control characters 
Control I, 3-41 
CTRL H, 1-2 
CTRL X, 1-2 

Control options, 3 

Current line, 1-6 


DELETE command, 3- 


Delimiters, 1-6 
Disk devices, 1-1 
DONE command, 3-20 


je hee 
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Edit command syntax, 1-9 


Edit features, 1-4 


BIOC-related, 3-6 


Edit load module, 
Edit requirements, 
Edit session, 4-1 
END command, 3-21 


File 
class, 1-4 
descriptors, 1-3 
group, 1-4 
private, 1-4 
system, 1-4 
Filename, 1-4 
FIND command, 3-22 


2-2 
1-1 


Formatting data, 1-8 


GET command, 3-24 
Group file, 1-4 


HELP command, 3-26 


Hexadecimal editing, 1-4, 


3-41 
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Hexadecimal, 1-4, 3-38, 3-40 
Identifying data, 1-4 
INCLUDE command, 3-27 
Input mode, 1-1, 1-2 
INSERT command, 3-30 
Interactive 

command mode, 1-1 

input mode, 1-1 
Interactive, 3-5, 3-45 


Line 


length, 1-8, 3-3, 3-15, 3-47 


number, 1-4 

per screen, 3-39 
LINK NUMBER command, 3-32 
‘Loading Edit, 2-1, 2-2 
from an MTM terminal, 2-1 


from the system console, 2-2 


Messages, 1-11, B-l 
MINUS SIGN command, 3-60 
Mode 
ASCII, 1-4 
command, 1-1, 1-2 
hexadecimal, 1-4 
input, 1-1, 1-2 
MOVE command, 3-33 


NOFIND command, 3-35 
NOTRUNCATE command, 3-37 
Null line, 1-2 


Operating system prompt, 3-52 
OPTION command, 3-38 

BIOC, 3-40, 3-42 

BLOCK, 3-39 

COMMAND, 3-39 

CONTINUE, 3-40 

ENFORCE, 3-40 

EXIT, 3-40 

INPLACE, 3-40 

LENGTH, 3-39 


LOG, 3-39 
MODE, 3-39 


NOBIOC, 3-40 
NOLOG, 3-39 
NOTAB, 3-39 
NOVERIFY, 3-39 
NOWINDOW, 3-40 
SCREEN, 3-39 
TAB, 3-39 
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OPTION command (Continued) 
TERMINATOR, 3-39 
VERIFY, 3-18, 3-39 
WARNING, 3-40 
WINDOW, 3-40 


PAUSE command, 3-44 

PLUS SIGN command, 3-59 

Private file, 1-4 

Prompts, 1-2 
command, 1-2 
disabled, under MTM, 2-2 
greater than sign, 1-2 
line, 1-2 
operating system, 3-52 


Ranges, 1-6 
REPLACE command, 3-45 
RULER command, 3-47 


Sample Edit session, 4-1 
SAVE command, 3-48 

SCREEN command, 3-51 

SEND STOP command, 3-52 
Starting Edit, 2-3 

Statement syntax conventions, 


SUBSTITUTE command, 3-53, 3-56 


System environments, 1-1 
System file, 1-4 


Tab 

character, 3-39 

settings, 1-9, 3-39 
Tabulation points, 3-42 
Temporary file support, 1-1 
Terminator, 3-39, 3-42 
Text display, 1-8 
TOP command, 3-55 
TRUNCATE command, 3-56 
TYPE command, 3-57 


Verification, 1-9 


WINDOW, use of, 3-40 
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